@fewangsit/wangsvue-fats 1.0.0-alpha.31 → 1.0.0-alpha.32

package/plugins/i18n.d.ts

@@ -2,93 +2,97 @@ import { App, Ref } from 'vue';
 import { AxiosResponse } from 'axios';
 export type Locale = string;
 export interface LanguageOption {
-    /**
-     * ISO 639-1 language code (e.g., "en" for English, "fr" for French).
-     */
-    isoCode?: string;
-    /**
-     * The name of the language in English (e.g., "English", "Français").
-     */
-    name: string;
-    /**
-     * The URL of the country's flag image.
-     * Flags are sourced from https://flagcdn.com and are typically in SVG format for high-quality resolution.
-     */
-    flag?: string;
+  /**
+   * ISO 639-1 language code (e.g., "en" for English, "fr" for French).
+   */
+  isoCode?: string;
+  /**
+   * The name of the language in English (e.g., "English", "Français").
+   */
+  name: string;
+  /**
+   * The URL of the country's flag image.
+   * Flags are sourced from https://flagcdn.com and are typically in SVG format for high-quality resolution.
+   */
+  flag?: string;
 }
 export interface I18n {
-    /**
-     * Locale message translation
-     *
-     * @param key - The translation key
-     * @param params - A values of named interpolation
-     * @param args - Positional interpolation values
-     *
-     * @returns translation message
-     * @example `t('Hello {user}!', { user: 'John Doe' })` - returns: 'Hello John Doe!'
-     * @example `t('Hello %s! I am %s.', "John Doe", "Peter Smith")` - returns: 'Hello John Doe! I am Peter Smith.'
-     */
-    t: {
-        (key: string, params: Record<string, any>): string;
-        (key: string, ...args: (string | number | boolean)[]): string;
-    };
-    /**
-     * Change the locale dynamically
-     *
-     * @param newLocale - The locale to switch to
-     */
-    setLocale: (newLocale: Locale) => Promise<void>;
-    /**
-     * Get the current locale
-     *
-     * @returns Current locale
-     */
-    locale: Ref<Locale>;
-    /**
-     * Service methods handle fetch requests
-     */
-    service?: I18nService;
+  /**
+   * Locale message translation
+   *
+   * @param key - The translation key
+   * @param params - A values of named interpolation
+   * @param args - Positional interpolation values
+   *
+   * @returns translation message
+   * @example `t('Hello {user}!', { user: 'John Doe' })` - returns: 'Hello John Doe!'
+   * @example `t('Hello %s! I am %s.', "John Doe", "Peter Smith")` - returns: 'Hello John Doe! I am Peter Smith.'
+   */
+  t: {
+    (key: string, params: Record<string, any>): string;
+    (key: string, ...args: (string | number | boolean)[]): string;
+  };
+  /**
+   * Change the locale dynamically
+   *
+   * @param newLocale - The locale to switch to
+   */
+  setLocale: (newLocale: Locale) => Promise<void>;
+  /**
+   * Get the current locale
+   *
+   * @returns Current locale
+   */
+  locale: Ref<Locale>;
+  /**
+   * Service methods handle fetch requests
+   */
+  service?: I18nService;
 }
 type MessageMap = Record<string, string>;
 export interface I18nService {
-    /**
-     * Fetch all translation messages for a specific locale.
-     * @param locale The locale code (e.g., 'en', 'id').
-     * @returns A promise resolving to a key-value record of messages.
-     */
-    getMessages(locale: string): Promise<AxiosResponse<{
-        data: MessageMap;
-    }>>;
-    /**
-     * Fetch all available lang options for LanguageDropdown and LanguageSwitcher
-     *
-     * @returns Promise Array of options
-     */
-    getLanguageOptions(): Promise<LanguageOption[]>;
-    /**
-     * Fetch single lang option meta data
-     *
-     * @param locale The locale code (e.g., 'en', 'id').
-     * @returns Promise LanguageMeta
-     */
-    getLanguageOptionMeta(locale: string): Promise<LanguageOption>;
-    /**
-     * Translate a specific text to the target locale.
-     * @param key Unique translation key.
-     * @param locale Target locale code.
-     * @returns A promise resolving to the translated string.
-     */
-    translateText(key: string, locale: string): Promise<string>;
+  /**
+   * Fetch all translation messages for a specific locale.
+   * @param locale The locale code (e.g., 'en', 'id').
+   * @returns A promise resolving to a key-value record of messages.
+   */
+  getMessages(locale: string): Promise<
+    AxiosResponse<{
+      data: MessageMap;
+    }>
+  >;
+  /**
+   * Fetch all available lang options for LanguageDropdown and LanguageSwitcher
+   *
+   * @returns Promise Array of options
+   */
+  getLanguageOptions(): Promise<LanguageOption[]>;
+  /**
+   * Fetch single lang option meta data
+   *
+   * @param locale The locale code (e.g., 'en', 'id').
+   * @returns Promise LanguageMeta
+   */
+  getLanguageOptionMeta(locale: string): Promise<LanguageOption>;
+  /**
+   * Translate a specific text to the target locale.
+   * @param key Unique translation key.
+   * @param locale Target locale code.
+   * @returns A promise resolving to the translated string.
+   */
+  translateText(key: string, locale: string): Promise<string>;
 }
 export declare const useI18n: () => I18n;
 declare const i18n: {
-    install: (app: App) => void;
+  install: (app: App) => void;
 };
-export declare const createI18nWithExtension: (service: I18nService) => typeof i18n;
+export declare const createI18nWithExtension: (
+  service: I18nService,
+) => typeof i18n;
 export default i18n;
 declare module 'vue' {
-    interface ComponentCustomProperties {
-        $i18n: I18n;
-        $t: I18n['t'];
-    }
+  interface ComponentCustomProperties {
+    $i18n: I18n;
+    $t: I18n['t'];
+  }
 }

package/utils/date.util.d.ts

@@ -1,32 +1,58 @@
-export type TDateFormat = 'd/m/yy' | 'm/d/yy' | 'd/mm/yy' | 'dd/mm/yy' | 'dd/mm/yyyy' | 'dd M yy' | 'dd M yyyy' | 'dd MM yy' | 'dd MM yyyy' | 'D dd M yy' | 'D dd M yyyy' | 'DD dd MM yy' | 'DD dd MM yyyy' | 'D, dd M yy' | 'D, dd M yyyy' | 'DD, dd MM yy' | 'DD, dd MM yyyy';
-export type GoDateLayout = '02/01/06' | '_2/_1/06' | '_1/_2/06' | '02 Jan 06' | 'Mon, 02 Jan 06' | 'Mon, 02 Jan 2006';
+export type TDateFormat =
+  | 'd/m/yy'
+  | 'm/d/yy'
+  | 'd/mm/yy'
+  | 'dd/mm/yy'
+  | 'dd/mm/yyyy'
+  | 'dd M yy'
+  | 'dd M yyyy'
+  | 'dd MM yy'
+  | 'dd MM yyyy'
+  | 'D dd M yy'
+  | 'D dd M yyyy'
+  | 'DD dd MM yy'
+  | 'DD dd MM yyyy'
+  | 'D, dd M yy'
+  | 'D, dd M yyyy'
+  | 'DD, dd MM yy'
+  | 'DD, dd MM yyyy';
+export type GoDateLayout =
+  | '02/01/06'
+  | '_2/_1/06'
+  | '_1/_2/06'
+  | '02 Jan 06'
+  | 'Mon, 02 Jan 06'
+  | 'Mon, 02 Jan 2006';
 export type TTimeFormat = 'HH:mm' | 'HH:mm a' | 'HH:mm:ss' | 'HH:mm:ss a';
 export type GoTimeLayout = '15:04' | '03:04 PM' | '15:04:05' | '03:04:05 PM';
-export type CustomDateTimeFormatOptions = Omit<Intl.DateTimeFormatOptions, 'timeZone'> & {
-    timezone?: string;
-    locale?: string;
+export type CustomDateTimeFormatOptions = Omit<
+  Intl.DateTimeFormatOptions,
+  'timeZone'
+> & {
+  timezone?: string;
+  locale?: string;
 };
 export type DateOptions = {
-    locale?: string;
-    dateFormat?: TDateFormat | GoDateLayout;
-    timeFormat?: TTimeFormat | GoTimeLayout;
-    timezone?: string;
-    /**
-     * Show the time in the formatted date.
-     *
-     * @default true - when `timeFormat` is provided
-     */
-    showTime?: boolean;
-    /**
-     * Show the date in the formatted date.
-     *
-     * @default true
-     */
-    showDate?: boolean;
-    /**
-     * This is old format (general settings), if configuration still using old settings then this option parameter can be used
-     */
-    formatPreset?: CustomDateTimeFormatOptions;
+  locale?: string;
+  dateFormat?: TDateFormat | GoDateLayout;
+  timeFormat?: TTimeFormat | GoTimeLayout;
+  timezone?: string;
+  /**
+   * Show the time in the formatted date.
+   *
+   * @default true - when `timeFormat` is provided
+   */
+  showTime?: boolean;
+  /**
+   * Show the date in the formatted date.
+   *
+   * @default true
+   */
+  showDate?: boolean;
+  /**
+   * This is old format (general settings), if configuration still using old settings then this option parameter can be used
+   */
+  formatPreset?: CustomDateTimeFormatOptions;
 };
 export declare const formatDate: (date: Date, options?: DateOptions) => string;
 export declare const formatISODate: (date: string | Date) => string;
@@ -37,10 +63,13 @@ export declare const formatISODate: (date: string | Date) => string;
  * @param maxSeconds - Max value of seconds difference. Use it for formats a date according to the user's general settings.
  * @returns The formatted date string.
  */
-export declare const formatDateReadable: (date: Date, maxSeconds?: number) => string;
+export declare const formatDateReadable: (
+  date: Date,
+  maxSeconds?: number,
+) => string;
 export declare const getRemainingTime: (deadline: string) => {
-    seconds: number;
-    days: number;
-    hours: number;
-    minutes: number;
+  seconds: number;
+  days: number;
+  hours: number;
+  minutes: number;
 };

package/utils/getSeverityByAssetStatus.util.d.ts

@@ -0,0 +1,3 @@
+export type Severities = 'success' | 'danger' | 'warning' | 'dark' | 'primary';
+declare const _default: (status?: string) => Severities;
+export default _default;

package/utils/index.d.ts

@@ -0,0 +1,8 @@
+export { formatDate } from '../utils/date.util';
+export * from '../components/tree/helpers/filterNodeKeys.helper';
+export * from './role.util';
+export * from './listenSidebarChanges.util';
+export { checkRouteAccess } from './role.util';
+export { ZIndexUtils } from 'primevue/utils';
+export { default as useToast } from './toast.util';
+export { default as flattenTreeNodeChildren } from '../components/tree/helpers/flattenTreeNodeChildren.helper';

package/utils/listenSidebarChanges.util.d.ts

@@ -0,0 +1,16 @@
+import { TreeNode } from '../components/basetree/BaseTree.vue.d';
+export type SidebarEvent = CustomEvent<{
+  /**
+   * Stringified keys array.
+   */
+  keys: string;
+  node: TreeNode;
+}>;
+export declare const listenSidebarChanges: (
+  type: 'group' | 'category',
+  callback: (e: SidebarEvent) => any,
+) => void;
+export declare const unListenSidebarChanges: (
+  type: 'group' | 'category',
+  callback: (e: SidebarEvent) => any,
+) => void;

package/utils/object.util.d.ts

@@ -1,14 +1,25 @@
 /**
  * Utility function to get nested property value.
  */
-export declare const getNestedPropertyValue: (obj: Record<string, any>, path: string) => any;
+export declare const getNestedPropertyValue: (
+  obj: Record<string, any>,
+  path: string,
+) => any;
 /**
  * Utility function to set nested property value.
  */
-export declare const setNestedPropertyValue: (obj: Record<string, any>, path: string, value: any) => void;
+export declare const setNestedPropertyValue: (
+  obj: Record<string, any>,
+  path: string,
+  value: any,
+) => void;
 export declare const isEmptyObject: (obj: object) => boolean;
 export declare const deepEquals: (a: object, b: object) => boolean;
-export declare const equals: (obj1: object, obj2: object, field?: string) => boolean;
+export declare const equals: (
+  obj1: object,
+  obj2: object,
+  field?: string,
+) => boolean;
 export declare const resolveFieldData: (data: object, field?: string) => object;
 export declare const contains: (value: object, list: object[]) => boolean;
 export declare const isNotEmpty: (value: object) => boolean;

package/utils/role.util.d.ts

@@ -0,0 +1,68 @@
+import { NavigationGuardNext, RouteLocationNormalized } from 'vue-router';
+export type TransactionRole = {
+  manager: boolean;
+  monitoringReport: boolean;
+  staff: boolean;
+  approver: boolean;
+};
+export type SystemRole = {
+  create: boolean;
+  view: boolean;
+  update: boolean;
+  delete: boolean;
+};
+export type SystemRoleAttribute =
+  | 'importData'
+  | 'assetAttribute'
+  | 'assetPolicies'
+  | 'depreciationGroup'
+  | 'depreciationMethod'
+  | 'documentDeletion'
+  | 'group'
+  | 'iotReader'
+  | 'license'
+  | 'purchaseDocument'
+  | 'purchaseInformation'
+  | 'userAndRole'
+  | 'tag'
+  | 'tagType'
+  | 'registerAsset';
+export type TransactionAttribute =
+  | 'borrowingRole'
+  | 'assignmentRole'
+  | 'disposalRole'
+  | 'transferRole'
+  | 'auditRole'
+  | 'maintenanceRole'
+  | 'repairRole'
+  | 'trackingRole'
+  | 'damagedRole'
+  | 'missingRole';
+export interface UserLogin {
+  transactionRoles: Record<TransactionAttribute, TransactionRole>;
+  systemRoles: Record<SystemRoleAttribute, SystemRole>;
+  userType: 'Admin' | 'Basic';
+}
+export declare const getTransactionRole: (
+  name: keyof UserLogin['transactionRoles'],
+) => TransactionRole;
+export declare const getSystemRole: (
+  name: keyof UserLogin['systemRoles'],
+) => SystemRole;
+export declare const hasSystemRole: (name: SystemRoleAttribute) => boolean;
+export declare const hasTransactionRole: (
+  name: TransactionAttribute,
+) => boolean;
+export declare const hasManagerRole: (name: TransactionAttribute) => boolean;
+export declare const hasAnyManagerRole: () => boolean;
+export declare const hasAnyMonitoringReportRole: () => boolean;
+export declare const hasStaffRole: (name: TransactionAttribute) => boolean;
+export declare const hasMonitoringReportRole: (
+  name: TransactionAttribute,
+) => boolean;
+export declare const hasApprovalRole: (name: TransactionAttribute) => boolean;
+export declare const checkRouteAccess: (
+  to: RouteLocationNormalized,
+  from: RouteLocationNormalized,
+  next: NavigationGuardNext,
+) => void;

package/utils/toast.util.d.ts

@@ -1,91 +1,91 @@
 import { WangsIcons } from '../components/icon/Icon.vue.d';
 export type ToastSeverity = 'success' | 'error' | 'info';
 export interface ToastParams {
-    /**
-     * The main message to display in the toast. Will be formatted based on template message.
-     */
-    message: string;
-    /**
-     * Indicates whether the message is customized and does not follow the default message template.
-     * If true, custom formatting will be applied.
-     */
-    customMessage?: boolean;
-    /**
-     * The severity level of the toast message.
-     * Can be 'success', 'error', or 'info'.
-     */
-    severity?: ToastSeverity;
-    /**
-     * The icon to display in the toast.
-     */
-    icon?: WangsIcons;
-    /**
-     * The custom CSS class to apply to the icon.
-     */
-    iconClass?: any;
-    /**
-     * The error object from a catch statement, used to provide additional details for error toasts.
-     * Accepts any type of error object.
-     */
-    error?: unknown;
-    /**
-     * The duration for which the toast will be displayed, in milliseconds.
-     * Set to 0 to show the message infinitely.
-     *
-     * @default 3000 - 3 seconds
-     */
-    life?: number;
-    /**
-     * The name of the message group to which this toast belongs.
-     */
-    group?: string;
-    /**
-     * Unique identifier of the toast message.
-     */
-    messageId?: string;
+  /**
+   * The main message to display in the toast. Will be formatted based on template message.
+   */
+  message: string;
+  /**
+   * Indicates whether the message is customized and does not follow the default message template.
+   * If true, custom formatting will be applied.
+   */
+  customMessage?: boolean;
+  /**
+   * The severity level of the toast message.
+   * Can be 'success', 'error', or 'info'.
+   */
+  severity?: ToastSeverity;
+  /**
+   * The icon to display in the toast.
+   */
+  icon?: WangsIcons;
+  /**
+   * The custom CSS class to apply to the icon.
+   */
+  iconClass?: any;
+  /**
+   * The error object from a catch statement, used to provide additional details for error toasts.
+   * Accepts any type of error object.
+   */
+  error?: unknown;
+  /**
+   * The duration for which the toast will be displayed, in milliseconds.
+   * Set to 0 to show the message infinitely.
+   *
+   * @default 3000 - 3 seconds
+   */
+  life?: number;
+  /**
+   * The name of the message group to which this toast belongs.
+   */
+  group?: string;
+  /**
+   * Unique identifier of the toast message.
+   */
+  messageId?: string;
 }
 export interface ToastMethod {
-    add(params: ToastParams): void;
-    /**
-     * Clears the messages that belongs to the group.
-     * @param {string} group - Name of the message group.
-     */
-    removeGroup(group: string): void;
-    removeAllGroups(): void;
+  add(params: ToastParams): void;
+  /**
+   * Clears the messages that belongs to the group.
+   * @param {string} group - Name of the message group.
+   */
+  removeGroup(group: string): void;
+  removeAllGroups(): void;
 }
 /**
  * Configuration options for the `useToast` hook.
  */
 export interface UseToastConfig {
-    /**
-     * Default message templates for each severity level.
-     * Keys represent the severity, and values are the template strings.
-     *
-     * @example
-     * {
-     *   severity: {
-     *     success: 'Success, {message}',
-     *     error: 'Error, {message} {additionalMessage}',
-     *     info: 'Info, {message} {additionalMessage}',
-     *   },
-     *   additionalMessage: ' Silahkan cek kembali koneksi Anda.'
-     * }
-     */
-    template?: {
-        severity?: Record<string, string>;
-        additionalMessage?: string;
-    };
-    /**
-     * Icons for each severity level.
-     * Keys represent the severity, and values are the corresponding icon identifiers.
-     *
-     * @example
-     * {
-     *   success: 'emotion-happy-fill',
-     *   error: 'emotion-unhappy-fill',
-     * }
-     */
-    icons?: Record<string, WangsIcons>;
+  /**
+   * Default message templates for each severity level.
+   * Keys represent the severity, and values are the template strings.
+   *
+   * @example
+   * {
+   *   severity: {
+   *     success: 'Success, {message}',
+   *     error: 'Error, {message} {additionalMessage}',
+   *     info: 'Info, {message} {additionalMessage}',
+   *   },
+   *   additionalMessage: ' Silahkan cek kembali koneksi Anda.'
+   * }
+   */
+  template?: {
+    severity?: Record<string, string>;
+    additionalMessage?: string;
+  };
+  /**
+   * Icons for each severity level.
+   * Keys represent the severity, and values are the corresponding icon identifiers.
+   *
+   * @example
+   * {
+   *   success: 'emotion-happy-fill',
+   *   error: 'emotion-unhappy-fill',
+   * }
+   */
+  icons?: Record<string, WangsIcons>;
 }
 /**
  * Hook to create and manage toast notifications.

package/utils/addAttachment.util.d.ts

@@ -1,43 +0,0 @@
-export type FileType = 'link' | 'image' | 'txt' | 'doc' | 'xls' | 'pdf' | 'csv' | 'html' | 'json' | 'mp4' | 'mkv' | 'compressed' | 'unknown';
-export type FormattedFile = {
-    name: string;
-    type: string;
-    size: number;
-    webkitRelativePath: string;
-    fileType: FileType;
-    file: File;
-    imgPreviewURL?: string;
-    uploadProgress?: number;
-    controller?: AbortController;
-    isCanceled?: boolean;
-};
-/**
- * Maps a mime type to a custom file type.
- *
- * @param {string} mimeType
- * @returns {CustomFileType}
- */
-export declare const getFileType: (mimeType: string) => FileType;
-/**
- * Formats a file into a FormattedFile object.
- *
- * @param file The file to be formatted.
- * @returns A FormattedFile object.
- */
-export declare const formatFile: (file: File) => FormattedFile;
-/**
- * Checks if a file is under the maximum size limit.
- *
- * @param file The file to be checked.
- * @param customFileSize The maximum size limit in megabytes. @default 1
- * @returns True if the file is under the maximum size limit, false otherwise.
- */
-export declare const validateFileSize: (file: File, customFileSize?: number) => boolean;
-/**
- * Checks if a file has a valid type.
- * Make sure user doesn't upload a folder.
- *
- * @param file The file to be checked.
- * @returns True if the file has a valid type, false otherwise.
- */
-export declare const validateFileType: (file: File) => boolean;

package/utils/exportToExcel.util.d.ts

@@ -1,20 +0,0 @@
-export interface ITable {
-    headers: string[];
-    data: Record<string, unknown>[];
-    tableName: string;
-    tableTitle?: string;
-}
-interface IExcelOptions {
-    tables: ITable[];
-    fileName: string;
-    additionalTexts?: (string | string[])[];
-}
-/**
- * Function to export excel, previously this only handle for 1 table in 1 file
- * Now this function has been refactored to be able to format multiple tables in 1 file without altered its original functionality
- * However, the way to called this function is changing a little bit (look for component DataTable and find usage of util `exportToExcel`)
- *
- * @param options - param that contain tables and filename for excel
- */
-declare const exportToExcel: (options: IExcelOptions) => Promise<void>;
-export default exportToExcel;

package/utils/filterOptions.util.d.ts

@@ -1,3 +0,0 @@
-import { Option } from '../components/dropdown/Dropdown.vue.d';
-declare const filterOptions: (options?: Option[] | string[]) => Option[] | string[];
-export default filterOptions;

package/utils/genPlaceholder.util.d.ts

@@ -1,8 +0,0 @@
-export declare const genRandomPlaceholderBg: () => string;
-export declare const genPlaceholder: (text: string, size: 30 | 125, bgColor?: string, fontOptions?: {
-    font?: string;
-    fontWeight?: string;
-    fontSize?: number;
-    fontColor?: string;
-}) => HTMLCanvasElement;
-export default genPlaceholder;