@unipin/angular-applet 18.9.3 → 18.9.5

package/projects/unipin-angular/src/lib/utils/form-error-message/form-error-message.util.spec.ts

@@ -0,0 +1,58 @@
+import { getFormErrorMessage } from './form-error-message.util';
+
+describe('FormErrorMessageUtil', () => {
+  describe('getFormErrorMessage', () => {
+    it('should return an empty string for null error', () => {
+      const result = getFormErrorMessage(null);
+      expect(result).toBe('');
+    });
+
+    it('should return `Column` as the name when label is not provided', () => {
+      const error = { email: { requiredLength: 5 } };
+      const result = getFormErrorMessage(error);
+      
+      expect(result).toBe('Column is not a valid email');
+    });
+
+    it('should handle email validation error', () => {
+      const error = { email: { requiredLength: 5 } };
+      const result = getFormErrorMessage(error, 'Email');
+      
+      expect(result).toBe('Email is not a valid email');
+    });
+
+    it('should handle required validation error', () => {
+      const error = { required: { requiredLength: 5 } };
+      const result = getFormErrorMessage(error, 'Name');
+      expect(result).toBe('Name is required');
+    });
+
+    it('should handle minlength validation error', () => {
+      const error = { minlength: { requiredLength: 5 } };
+      const result = getFormErrorMessage(error, 'MinLength');
+      
+      expect(result).toBe('MinLength must be at least 5 characters');
+    });
+
+    it('should handle maxlength validation error', () => {
+      const error = { maxlength: { requiredLength: 10 } };
+      const result = getFormErrorMessage(error, 'MaxLength');
+      
+      expect(result).toBe('MaxLength must not exceed 10 characters');
+    });
+
+    it('should handle min validation error', () => {
+      const error = { min: { min: 5 } };
+      const result = getFormErrorMessage(error, 'Min');
+      
+      expect(result).toBe('Min value must be larger than 5');
+    });
+
+    it('should handle max validation error', () => {
+      const error = { max: { max: 10 } };
+      const result = getFormErrorMessage(error, 'Max');
+      
+      expect(result).toBe('Max value must be lower than 10');
+    });
+  });
+});

package/projects/unipin-angular/src/lib/utils/form-error-message/form-error-message.util.ts

@@ -0,0 +1,30 @@
+import { ValidationErrors } from '@angular/forms';
+
+const errMessage: { [k: string]: (l: string, arg?: number) => string } = {
+  email: (label: string) => `${ label } is not a valid email`,
+  required: (label: string) => `${ label } is required`,
+  minlength: (label: string, length?: number) => `${ label } must be at least ${ length } characters`,
+  maxlength: (label: string, length?: number) => `${ label } must not exceed ${ length } characters`,
+  max: (label: string, max?: number) => `${ label } value must be lower than ${ max }`,
+  min: (label: string, min?: number) => `${ label } value must be larger than ${ min }`,
+};
+
+const extraParamKey: { [k: string]: string } = {
+  minlength: 'requiredLength',
+  maxlength: 'requiredLength',
+  max: 'max',
+  min: 'min'
+};
+
+/**
+ * A function that get detail error description based on param err.
+ * @param {ValidationErrors | null} err - Contain error from the form input.
+ * @param {string} label - Contain label name of the form input.
+ * @returns {string} Contain either detail error description or empty string ('')
+ */
+export function getFormErrorMessage(err: ValidationErrors | null, label?: string): string{
+  if (!err) return '';
+
+  const key = Object.keys(err)[0];
+  return errMessage[key](label?? 'Column', err[key][extraParamKey[key]]);
+}

package/projects/unipin-angular/src/lib/utils/format-capitalize/format-capitalize.util.spec.ts

@@ -0,0 +1,30 @@
+import { formatCapitalize } from './format-capitalize.util';
+
+describe('FormatCapitalizeUtil', () => {
+  describe('formatCapitalize', () => {
+    it('should return a single capitalized word', () => {
+      const result = formatCapitalize('ACTIVE');
+      expect(result).toBe('Active');
+    });
+
+    it('should return a sentence with a single capitalized charater at front and separated by space', () => {
+      const result = formatCapitalize(['KEEP', 'iN', 'VIEW'], false);
+      expect(result).toBe('Keep in view');
+    });
+
+    it('should return a sentence with every words are capitalized and separated by space', () => {
+      const result = formatCapitalize(['KEEP', 'iN', 'VIEW'], true);
+      expect(result).toBe('Keep In View');
+    });
+
+    it('should return a sentence with a single capitalized charater at front and separated by _', () => {
+      const result = formatCapitalize(['KEEP', 'iN', 'VIEW'], false, '_');
+      expect(result).toBe('Keep_in_view');
+    });
+
+    it('should return a sentence with every words are capitalized and separated by _', () => {
+      const result = formatCapitalize(['KEEP', 'iN', 'VIEW'], true, '_');
+      expect(result).toBe('Keep_In_View');
+    });
+  });
+});

package/projects/unipin-angular/src/lib/utils/format-capitalize/format-capitalize.util.ts

@@ -0,0 +1,22 @@
+/**
+ * A function that create a capitalize word.
+ * @param {string | string[]} str - Word that want to be capitalized.
+ * @param {boolean} [eachWord=false] - Determine whether each word will be capitalize or not by a certain separator. If the first param is not array, this parameter will be ignored. Default to `false`.
+ * @param {string} [separator=" "] - A string used to separate one element of the words from the next in the resulting string. If the first param is not array, this parameter will be ignored. If omitted, words are separated with a space.
+ * @returns {string} Capitalized word string
+ */
+export function formatCapitalize(str: string | string[], eachWord: boolean = false, separator: string = ' '): string{
+  if (!str) return str;
+  if (typeof str === 'string') return `${ str.at(0)!.toUpperCase() }${ str.substring(1).toLowerCase() }`;
+
+  str[0] = `${ str[0].at(0)!.toUpperCase() }${ str[0].substring(1).toLowerCase() }`;
+  for (let i = 1; i < str.length; i++) {
+    if (!str[i]) continue;
+
+    if (!eachWord) str[i] = str[i].toLowerCase();
+    else {
+      str[i] = `${ str[i].at(0)!.toUpperCase() }${ str[i].substring(1).toLowerCase() }`;
+    }
+  }
+  return str.join(separator);
+}

package/projects/unipin-angular/src/lib/utils/redirect-to-first-menu/redirect-to-first-menu.util.ts

@@ -0,0 +1,15 @@
+import { inject } from '@angular/core';
+import { RedirectFunction } from '@angular/router';
+import { PermissionService } from '../../modules';
+import { AppletConfig, APPLET_CONFIG } from '../../components';
+
+/**
+ * Redirects the user to their first accessible menu route based on permissions.
+ * @returns {RedirectFunction} The first allowed route
+ */
+export function redirectToFirstMenu(): ReturnType<RedirectFunction>{
+	const { permModules } = inject(PermissionService);
+	const { containers } = inject<AppletConfig>(APPLET_CONFIG);
+
+	return containers.find(({ permModule }) => permModules.value.includes(permModule))?.path?? containers[0].path;
+}

package/projects/unipin-angular/src/public-api.ts

@@ -0,0 +1,126 @@
+/*
+ * Public API Surface of unipin-angular
+ */
+export {
+  ButtonGroupConfig,
+  ButtonGroupComponent,
+  ButtonLoadingComponent,
+
+  FormDateComponent,
+  FormInputComponent,
+  FormNumberComponent,
+  FormPasswordComponent,
+  FormSearchableSelectComponent,
+  FormSelectComponent,
+  FormTextareaComponent,
+  FormImagePickerComponent,
+  FormCurrencyInputComponent,
+  FormCountryInputComponent,
+  FormRateGroupCodeInputComponent,
+  
+  FilterConfig,
+  FilterField,
+  FilterSearchEvent,
+  FilterComponent,
+
+  GridConfig,
+  GridService,
+  GridPaginationComponent,
+  GridSnapshotComponent,
+
+  AppletConfig,
+  APPLET_CONFIG,
+  provideAppletConfig,
+  AppletContainerComponent,
+
+  ColumnContainerComponent,
+  ColumnHeaderContainerComponent,
+  ListContainerConfig, 
+  ListPaginationContainerComponent, 
+  ListSnapshotContainerComponent,
+  ModalContainerComponent,
+
+  TabContentComponent,
+  TabGroupComponent,
+  TabsChangedEvent,
+
+  AuditListComponent,
+  AuditDetailComponent,
+
+  APPROVAL_ENTITIES,
+  provideApprovalEntities,
+  ApprovalService,
+  ApprovalListComponent,
+  
+  ApprovalDetailComponent
+} from './lib/components';
+
+export {
+  InfiniteScrollDirective,
+  InfiniteScrollComponent
+} from './lib/components/infinite-scroll';
+
+export {
+  AuthGuard
+} from './lib/guards';
+
+export {
+  headerInterceptor,
+  /**
+   * @deprecated - DI based interceptor will be removed at v19.0.0, use function based interceptor instead
+   */
+  HeaderInterceptor,
+  
+  refreshTokenInterceptor,
+  /**
+   * @deprecated - DI based interceptor will be removed at v19.0.0, use function based interceptor instead
+   */
+  RefreshTokenInterceptor
+} from './lib/interceptors';
+
+export {
+  User
+} from './lib/interfaces';
+
+export { 
+  bootstrap,
+
+  LoadingConfig,
+  provideLoadingConfig,
+  LoadingPage,
+
+  UnauthorizedPage,
+
+  PermissionDirective,
+  PermissionGuard,
+  PermissionService,  
+} from './lib/modules';
+
+export {
+  AuthResolver
+} from './lib/resolvers';
+
+export {
+  AuthService,
+  CurrencyService,
+  CountryService,
+  RateGroupCodeService,
+  ProfileService,
+} from './lib/services';
+
+export {
+  formatCapitalize,
+  generateContrastColor,
+  getFormErrorMessage,
+  redirectToFirstMenu
+} from './lib/utils';
+
+export {
+  GridApi,
+  GridReadyEvent,
+  ICellRendererParams,
+  ValueFormatterParams,
+  SelectionChangedEvent
+} from '@ag-grid-community/core';
+
+export { ICellRendererAngularComp } from '@ag-grid-community/angular';

package/projects/unipin-angular/tsconfig.lib.json

@@ -0,0 +1,14 @@
+/* To learn more about this file see: https://angular.io/config/tsconfig. */
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../out-tsc/lib",
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "types": []
+  },
+  "exclude": [
+    "**/*.spec.ts"
+  ]
+}

package/projects/unipin-angular/tsconfig.lib.prod.json

@@ -0,0 +1,10 @@
+/* To learn more about this file see: https://angular.io/config/tsconfig. */
+{
+  "extends": "./tsconfig.lib.json",
+  "compilerOptions": {
+    "declarationMap": false
+  },
+  "angularCompilerOptions": {
+    "compilationMode": "partial"
+  }
+}

package/projects/unipin-angular/tsconfig.spec.json

@@ -0,0 +1,14 @@
+/* To learn more about this file see: https://angular.io/config/tsconfig. */
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../out-tsc/spec",
+    "types": [
+      "jasmine"
+    ]
+  },
+  "include": [
+    "**/*.spec.ts",
+    "**/*.d.ts"
+  ]
+}

package/snapshot-serializer.js

@@ -0,0 +1,12 @@
+const jestSerializerHtml = require('jest-serializer-html');
+const DYNAMIC_ID_PATTERN = /"react-aria-\d+(\.\d+)?"/g;
+
+module.exports = {
+  serialize(val) {
+    const withFixedIds = val.replace(DYNAMIC_ID_PATTERN, 'mocked_id');
+    return jestSerializerHtml.print(withFixedIds);
+  },
+  test(val) {
+    return jestSerializerHtml.test(val);
+  },
+};

package/test-runner-jest.config.js

@@ -0,0 +1,13 @@
+import { getJestConfig } from '@storybook/test-runner';
+
+const defaultConfig = getJestConfig();
+
+const config = {
+  ...defaultConfig,
+  snapshotSerializers: [
+    './snapshot-serializer.js',
+    ...defaultConfig.snapshotSerializers,
+  ],
+};
+
+export default config;

package/tsconfig.json

@@ -0,0 +1,51 @@
+/* To learn more about this file see: https://angular.io/config/tsconfig. */
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "baseUrl": "./",
+    "outDir": "./dist/out-tsc",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "esModuleInterop": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "sourceMap": true,
+    "declaration": false,
+    "downlevelIteration": false,
+    "experimentalDecorators": true,
+    "moduleResolution": "node",
+    "importHelpers": true,
+    "target": "ES2022",
+    "module": "ES2022",
+    "useDefineForClassFields": false,
+    "lib": [
+      "ES2022",
+      "dom"
+    ],
+
+    "allowUnreachableCode": false,
+    "allowUnusedLabels": false,
+    "noImplicitAny": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strictNullChecks": true,
+    "strictPropertyInitialization": true,
+    "removeComments": true,
+    "stripInternal": true,
+    "noErrorTruncation": true,
+    "paths": {
+      "unipin-angular": [
+        "dist/unipin-angular"
+      ]
+    }
+  },
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "strictTemplates": true
+  }
+}