@skysoftware-co/bayan-core-widgets-ui 0.0.6 → 0.0.8

package/README.md

@@ -1,339 +1,3 @@
 # @skysoftware-co/bayan-core-widgets-ui
 
-Reusable Angular widgets for Bayan top-menu scenarios.
-
-## Package Surface
-
-This package currently exports:
-
-- `BayanCoreTopMenuWidgetComponent`
-- `BayanCoreTopMenuService`
-- shared DTOs from `menu.dtos`
-
-The child widgets are documented below because they make up the top-menu contract, but they are currently intended for internal composition rather than direct package consumption.
-
-## Installation
-
-```bash
-npm install @skysoftware-co/bayan-core-widgets-ui
-```
-
-## Basic Usage
-
-```html
-<bayan-core-top-menu-widget
-  [baseUrl]="appBaseUrl"
-  [systemModule]="systemModule"
-  [sidebarCollapsed]="sidebarCollapsed"
-  [homeUrl]="homeUrl"
-  [logoUrl]="logoUrl"
-  [collapsedLogoUrl]="collapsedLogoUrl"
-  [menuItems]="menuItems"
-  [searchItems]="searchItems"
-  [nameModeItems]="nameModeItems"
-  [showGlobalSearch]="true"
-  [showUserPanel]="true"
-  [showSettings]="true"
-  [showNotifications]="true"
-  [showHelp]="true"
-  [useInternalDialogs]="true"
-  [aboutDialog]="aboutDialog"
-  [changePasswordDialog]="changePasswordDialog"
-  (menuItemClick)="onMenuItemClick($event)"
-  (searchSubmit)="onSearchSubmit($event)"
-  (searchItemNavigate)="onSearchItemNavigate($event)"
-  (propertyChanged)="onPropertyChange($event)"
-  (signOutClick)="onSignOut()"
-  (submitPasswordChange)="onSubmitPasswordChange($event)">
-</bayan-core-top-menu-widget>
-```
-
-## Models
-
-```ts
-interface TopMenuWidgetItem {
-  id?: string | number;
-  menuName: string;
-  menuUrl?: string | null;
-  children?: TopMenuWidgetItem[];
-}
-
-interface TopMenuWidgetSearchItem {
-  id?: string | number;
-  menuTitle: string;
-  menuSubTitle: string;
-  menuUrl?: string | null;
-  iconClass?: string | null;
-  isTranslatable?: boolean;
-}
-
-interface TopMenuWidgetNameModeItem {
-  id: string;
-  text: string;
-  selected: boolean;
-}
-
-interface TopMenuWidgetAboutDialogConfig {
-  title?: string;
-  logoUrl?: string;
-  version?: string;
-  versionLabel?: string;
-  copyright?: string;
-  statusLabel?: string;
-  licenseButtonLabel?: string;
-  releaseNotesButtonLabel?: string;
-  supportButtonLabel?: string;
-  closeButtonLabel?: string;
-}
-
-interface TopMenuWidgetChangePasswordDialogConfig {
-  title: string;
-  currentPasswordLabel: string;
-  newPasswordLabel: string;
-  confirmNewPasswordLabel: string;
-  primaryButtonText: string;
-}
-
-interface TopMenuWidgetChangePasswordPayload {
-  currentPassword: string;
-  newPassword: string;
-  confirmNewPassword: string;
-}
-```
-
-## Top Menu Widget
-
-Selector: `bayan-core-top-menu-widget`
-
-### Inputs
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Base URL used to resolve internal and external navigation targets. |
-| `systemModule` | `SystemModule \| null` | `null` | Current system module context. |
-| `sidebarCollapsed` | `boolean` | `false` | Switches the brand area to the collapsed logo state. |
-| `homeUrl` | `string \| null` | `null` | Brand navigation target. |
-| `logoUrl` | `string` | Bayan CDN URL | Expanded logo source. |
-| `collapsedLogoUrl` | `string` | Bayan CDN URL | Collapsed logo source. |
-| `searchPlaceholder` | `string` | `'TopMenu.SearchPlaceholder'` | Search placeholder text or translation key. |
-| `menuItems` | `TopMenuWidgetItem[]` | `[]` | Top-level navigation items. |
-| `searchItems` | `TopMenuWidgetSearchItem[]` | `[]` | Autocomplete items for global search. |
-| `isSsoLogin` | `boolean` | `false` | Fallback SSO flag when the user panel does not provide one. |
-| `useAlternateNames` | `boolean` | `false` | Enables alternate-names behavior in settings. |
-| `displayAlternateNames` | `boolean` | `false` | Marks alternate names as active. |
-| `hrBlocked` | `boolean` | `false` | Current HR block state. |
-| `hrCanBlock` | `boolean` | `false` | Enables HR block and release actions. |
-| `tkBlocked` | `boolean` | `false` | Current Timekeeping block state. |
-| `tkCanBlock` | `boolean` | `false` | Enables Timekeeping block and release actions. |
-| `employeeNamesMode` | `AppFramePreferences` |  | Name display mode option from preferences. |
-| `settingsEnabled` | `boolean` | `true` | Enables settings interactions. |
-| `useInternalDialogs` | `boolean` | `false` | Shows built-in About and Change Password dialogs. |
-| `changePasswordLoading` | `boolean` | `false` | Loading state for the built-in Change Password dialog. |
-| `changePasswordDialog` | `TopMenuWidgetChangePasswordDialogConfig` | default labels | Built-in Change Password dialog labels. |
-| `aboutDialog` | `TopMenuWidgetAboutDialogConfig` | default labels | Built-in About dialog content and labels. |
-| `showGlobalSearch` | `boolean` | `false` | Shows the global search widget. |
-| `showUserPanel` | `boolean` | `false` | Shows the user panel widget. |
-| `showSettings` | `boolean` | `false` | Shows the settings widget. |
-| `showNotifications` | `boolean` | `true` | Shows the notifications widget. |
-| `notificationsTitle` | `string` | `'Notifications'` | Notification link title text or translation key. |
-| `showHelp` | `boolean` | `true` | Shows the help action. |
-| `helpTitle` | `string` | `'Help'` | Help link title text or translation key. |
-| `helpUrl` | `string \| null` | `null` | Help navigation target. |
-| `helpIcon` | `IconDefinition` | `faQuestionCircle` | Help icon. |
-| `helpAnchorClass` | `string` | `'menu-icon-btn top-menu-widget__help-link'` | CSS classes for the help anchor. |
-| `helpUrlTarget` | `'_self' \| '_blank' \| string` | `'_blank'` | Anchor target for the help action. |
-
-### Outputs
-
-| Name | Type | Description |
-|---|---|---|
-| `logoClick` | `EventEmitter<void>` | Fired when the brand link is clicked. |
-| `helpClick` | `EventEmitter<void>` | Fired when the help action is clicked. |
-| `menuItemClick` | `EventEmitter<TopMenuWidgetItem>` | Fired when a leaf menu item is activated. |
-| `searchSubmit` | `EventEmitter<string>` | Fired when free-text search is submitted. |
-| `searchItemNavigate` | `EventEmitter<TopMenuWidgetSearchItem>` | Fired when an autocomplete result is chosen. |
-| `propertyChanged` | `EventEmitter<PropertyOption>` | Fired when the active property changes. |
-| `signOutClick` | `EventEmitter<void>` | Fired when sign out is requested. |
-| `alternateNamesChange` | `EventEmitter<void>` | Fired when alternate names are toggled. |
-| `nameModeChange` | `EventEmitter<number>` | Fired when a name mode item is selected. |
-| `blockHrClick` | `EventEmitter<void>` | Fired when HR block is requested. |
-| `releaseHrClick` | `EventEmitter<void>` | Fired when HR release is requested. |
-| `blockTkClick` | `EventEmitter<void>` | Fired when Timekeeping block is requested. |
-| `releaseTkClick` | `EventEmitter<void>` | Fired when Timekeeping release is requested. |
-| `changePasswordClick` | `EventEmitter<void>` | Fired when Change Password is requested from settings. |
-| `openAboutClick` | `EventEmitter<void>` | Fired when About is requested from settings. |
-| `aboutLicenseClick` | `EventEmitter<void>` | Fired when the About dialog license action is clicked. |
-| `aboutReleaseNotesClick` | `EventEmitter<void>` | Fired when the About dialog release-notes action is clicked. |
-| `aboutSupportClick` | `EventEmitter<void>` | Fired when the About dialog support action is clicked. |
-| `submitPasswordChange` | `EventEmitter<TopMenuWidgetChangePasswordPayload>` | Fired when the built-in Change Password dialog is submitted. |
-
-## Internal Composition Widgets
-
-These widgets are used by the top-menu component and are documented here so the full contract is visible.
-
-### Global Search Widget
-
-Selector: `bayan-core-global-search-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Base URL used to resolve selected item URLs. |
-| `ActivePropertyChanged` | `boolean` | `false` | Boolean change token used to reset the search input after a property switch. |
-| `placeholder` | `string` | `'TopMenu.SearchPlaceholder'` | Placeholder text or translation key. |
-| `dataSource` | `TopMenuWidgetSearchItem[]` | `[]` | Search results shown in the autocomplete. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `search` | `EventEmitter<string>` | Fired when the user submits free-text search with Enter. |
-| `itemNavigate` | `EventEmitter<TopMenuWidgetSearchItem>` | Fired when the user selects a result item. |
-
-### Item Widget
-
-Selector: `bayan-core-item-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Base URL used to resolve item URLs. |
-| `ActivePropertyChanged` | `boolean` | `false` | Boolean change token used to close open menu branches after a property switch. |
-| `item` | `TopMenuWidgetItem` | required | Menu item to render. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `itemClick` | `EventEmitter<TopMenuWidgetItem>` | Fired when a leaf menu item is activated. |
-
-### Notifications Widget
-
-Selector: `bayan-core-notifications-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Base URL used to load the notifications summary and resolve its navigation URL. |
-| `title` | `string` | `'Notifications'` | Link title text or translation key. |
-| `wrapperClass` | `string` | `'notifications-icon-wrap menu-dropdown-host'` | Wrapper CSS classes. |
-| `linkClass` | `string` | `'menu-icon-btn cursor-pointer top-menu-widget__notification-btn'` | Anchor CSS classes. |
-| `iconClass` | `string` | `'fs-6'` | Bell icon CSS classes. |
-| `badgeClass` | `string` | `'top-menu-widget__notification-badge'` | Badge CSS classes. |
-
-Outputs: none.
-
-### Settings Widget
-
-Selector: `bayan-core-settings-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `ActivePropertyChanged` | `boolean` | `false` | Boolean change token used to close the settings menu after a property switch. |
-| `useAlternateNames` | `boolean` | `false` | Enables alternate names behavior. |
-| `displayAlternateNames` | `boolean` | `false` | Marks alternate names as active. |
-| `hrBlocked` | `boolean` | `false` | Current HR block state. |
-| `hrCanBlock` | `boolean` | `false` | Enables HR block and release actions. |
-| `tkBlocked` | `boolean` | `false` | Current Timekeeping block state. |
-| `tkCanBlock` | `boolean` | `false` | Enables Timekeeping block and release actions. |
-| `employeeNamesMode` | `AppFramePreferences` |  | Name mode option from preferences. |
-| `settingsEnabled` | `boolean` | `true` | Enables settings interactions. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `alternateNamesChange` | `EventEmitter<void>` | Fired when alternate names are toggled. |
-| `nameModeChange` | `EventEmitter<number>` | Fired when a name mode item is selected. |
-| `blockHrClick` | `EventEmitter<void>` | Fired when HR block is requested. |
-| `releaseHrClick` | `EventEmitter<void>` | Fired when HR release is requested. |
-| `blockTkClick` | `EventEmitter<void>` | Fired when Timekeeping block is requested. |
-| `releaseTkClick` | `EventEmitter<void>` | Fired when Timekeeping release is requested. |
-| `changePasswordClick` | `EventEmitter<void>` | Fired when Change Password is requested. |
-| `openAboutClick` | `EventEmitter<void>` | Fired when About is requested. |
-
-### User Panel Widget
-
-Selector: `bayan-core-user-panel-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Base URL used to load the current user panel and to switch the active property. |
-| `wrapperClass` | `string` | `'menu-dropdown-host'` | Wrapper CSS classes. |
-| `dropdownOpenClass` | `string` | `'open'` | CSS class added while the dropdown is open. |
-| `toggleButtonClass` | `string` | `'employee-toggle'` | Toggle button CSS classes. |
-| `employeeInfoClass` | `string` | `'employee-info'` | Employee info wrapper CSS classes. |
-| `userNameClass` | `string` | `'user-name'` | User name text CSS classes. |
-| `propertyNameClass` | `string` | `'property-name'` | Active property text CSS classes. |
-| `caretClass` | `string` | `'employee-caret'` | Caret CSS classes. |
-| `menuClass` | `string` | `'employee-menu menu-dropdown-panel'` | Dropdown menu CSS classes. |
-| `sectionLabelClass` | `string` | `'menu-section-label'` | Section label CSS classes. |
-| `menuItemClass` | `string` | `'menu-item'` | Property row CSS classes. |
-| `menuItemActiveClass` | `string` | `'menu-item-active'` | Active property CSS class. |
-| `indicatorClass` | `string` | `'menu-indicator'` | Selection indicator CSS classes. |
-| `invisibleIndicatorClass` | `string` | `'invisible'` | Hidden indicator CSS class. |
-| `dividerClass` | `string` | `'menu-divider'` | Divider CSS classes. |
-| `signOutButtonClass` | `string` | `'menu-item menu-item-signout'` | Sign-out button CSS classes. |
-| `showSignOutIcon` | `boolean` | `true` | Shows or hides the sign-out icon. |
-| `signOutIconClass` | `string` | `'mx-2'` | Sign-out icon CSS classes. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `propertyChanged` | `EventEmitter<PropertyOption>` | Fired after `switchProperty` succeeds and the widget refetches the user panel. |
-| `signOutClick` | `EventEmitter<void>` | Fired when sign out is requested. |
-
-### Change Password Widget
-
-Selector: `bayan-core-change-password-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Reserved for dialog-level extensibility. |
-| `visible` | `boolean` | `false` | Controls popup visibility. |
-| `config` | `TopMenuWidgetChangePasswordDialogConfig` | required | Dialog labels and title. |
-| `isSubmitting` | `boolean` | `false` | Disables editing while submission is in progress. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `visibleChange` | `EventEmitter<boolean>` | Fired when the dialog requests a visibility change. |
-| `submitPasswordChange` | `EventEmitter<TopMenuWidgetChangePasswordPayload>` | Fired with the form payload when save succeeds validation. |
-
-### About Dialog Widget
-
-Selector: `bayan-core-about-dialog-widget`
-
-Inputs:
-
-| Name | Type | Default | Description |
-|---|---|---|---|
-| `baseUrl` | `string` | `''` | Reserved for dialog-level extensibility. |
-| `visible` | `boolean` | `false` | Controls dialog visibility. |
-| `config` | `TopMenuWidgetAboutDialogConfig` | required | Dialog content and action labels. |
-
-Outputs:
-
-| Name | Type | Description |
-|---|---|---|
-| `visibleChange` | `EventEmitter<boolean>` | Fired when the dialog requests to close. |
-| `licenseClick` | `EventEmitter<void>` | Fired when the license action is clicked. |
-| `releaseNotesClick` | `EventEmitter<void>` | Fired when the release-notes action is clicked. |
-| `supportClick` | `EventEmitter<void>` | Fired when the support action is clicked. |
-
-## Build
-
-```bash
-npm run build -- --project BayanCoreComponents --configuration development
-```
+See `projects/bayan-core-ui/README.md` for the package documentation used during library publishing.

package/Web.config

@@ -0,0 +1,7 @@
+<?xml version="1.0"?>
+<configuration>
+  <system.web>
+    <compilation debug="false" targetFramework="4.8"/>
+    <pages controlRenderingCompatibilityVersion="4.0"/>
+  </system.web>
+</configuration>

package/angular.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "BayanCoreComponents": {
+      "projectType": "library",
+      "root": "projects/bayan-core-ui",
+      "sourceRoot": "projects/bayan-core-ui/src",
+      "prefix": "lib",
+      "architect": {
+        "build": {
+          "builder": "@angular-devkit/build-angular:ng-packagr",
+          "options": {
+            "project": "projects/bayan-core-ui/ng-package.json"
+          },
+          "configurations": {
+            "production": {
+              "tsConfig": "projects/bayan-core-ui/tsconfig.lib.prod.json"
+            },
+            "development": {
+              "tsConfig": "projects/bayan-core-ui/tsconfig.lib.json"
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "test": {
+          "builder": "@angular-devkit/build-angular:karma",
+          "options": {
+            "tsConfig": "projects/bayan-core-ui/tsconfig.spec.json",
+            "polyfills": [
+              "zone.js",
+              "zone.js/testing"
+            ]
+          }
+        }
+      }
+    }
+  },
+  "cli": {
+    "analytics": false
+  }
+}

package/package.json

@@ -1,36 +1,59 @@
 {
   "name": "@skysoftware-co/bayan-core-widgets-ui",
-  "version": "0.0.6",
-  "peerDependencies": {
-    "@angular/common": "19.2.14",
-    "@angular/core": "19.2.14",
-    "@ngx-translate/core": ">=15.0.0",
-    "@skysoftware-co/bayan-components-ui": ">=1.1.0",
-    "@skysoftware-co/sky-components-ui": ">=1.3.3",
-    "devextreme-angular": ">=23.0.0",
-    "@fortawesome/angular-fontawesome": ">=0.14.0",
-    "@fortawesome/pro-light-svg-icons": ">=6.0.0",
-    "@fortawesome/pro-solid-svg-icons": ">=6.0.0"
+  "version": "0.0.8",
+  "scripts": {
+    "ng": "ng",
+    "start": "ng serve",
+    "build": "ng build",
+    "watch": "ng build --watch --configuration development",
+    "test": "ng test"
   },
-  "main": "fesm2022/skysoftware-co-bayan-core-widgets-ui.mjs",
-  "module": "fesm2022/skysoftware-co-bayan-core-widgets-ui.mjs",
-  "typings": "index.d.ts",
-  "sideEffects": false,
-  "peerDependenciesMeta": {
-    "@ngx-translate/core": {
-      "optional": true
-    },
-    "devextreme-angular": {
-      "optional": true
-    },
-    "@fortawesome/angular-fontawesome": {
-      "optional": true
-    },
-    "@fortawesome/pro-light-svg-icons": {
-      "optional": true
-    },
-    "@fortawesome/pro-solid-svg-icons": {
-      "optional": true
-    }
+  "dependencies": {
+    "@angular-devkit/core": "^19.2.15",
+    "@angular/animations": "^19.2.14",
+    "@angular/cdk": "19.2.19",
+    "@angular/common": "^19.2.14",
+    "@angular/compiler": "^19.2.14",
+    "@angular/core": "^19.2.14",
+    "@angular/forms": "^19.2.14",
+    "@angular/material": "19.2.19",
+    "@angular/platform-browser": "^19.2.14",
+    "@angular/platform-browser-dynamic": "^19.2.14",
+    "@angular/router": "^19.2.14",
+    "@fortawesome/free-brands-svg-icons": "^7.0.0",
+    "@fortawesome/pro-light-svg-icons": "^7.0.0",
+    "@fortawesome/pro-regular-svg-icons": "^7.2.0",
+    "@ngx-translate/core": "^17.0.0",
+    "@skysoftware-co/bayan-components-ui": "^1.1.0",
+    "@skysoftware-co/sky-components-ui": "^1.3.3",
+    "crypto-js": "^4.2.0",
+    "moment": "^2.30.1",
+    "ngx-cookie-service": "^19.1.2",
+    "pdfjs-dist": "^5.4.149",
+    "rxjs": "~7.8.0",
+    "tslib": "^2.3.0",
+    "zone.js": "~0.15.1"
+  },
+  "devDependencies": {
+    "@angular-devkit/build-angular": "^19.2.15",
+    "@angular/cli": "^19.2.15",
+    "@angular/compiler-cli": "^19.2.14",
+    "@fortawesome/angular-fontawesome": "^1.0.0",
+    "@fortawesome/fontawesome-svg-core": "^7.0.0",
+    "@fortawesome/pro-solid-svg-icons": "^7.0.0",
+    "@types/jasmine": "~5.1.0",
+    "bootstrap": "^5.3.7",
+    "devextreme": "^24.1.7",
+    "devextreme-angular": "^24.1.7",
+    "devextreme-cli": "^1.6.7",
+    "devextreme-themebuilder": "^24.1.7",
+    "jasmine-core": "~5.2.0",
+    "karma": "~6.4.0",
+    "karma-chrome-launcher": "~3.2.0",
+    "karma-coverage": "~2.2.0",
+    "karma-jasmine": "~5.1.0",
+    "karma-jasmine-html-reporter": "~2.1.0",
+    "ng-packagr": "^19.2.2",
+    "typescript": "~5.7.2"
   }
 }