@fewangsit/wangsvue 1.5.216-alpha.0 → 1.5.217-alpha.0

package/utils/addAttachment.util.d.ts

@@ -1,15 +1,28 @@
-export type FileType = 'link' | 'image' | 'txt' | 'doc' | 'xls' | 'pdf' | 'csv' | 'html' | 'json' | 'mp4' | 'mkv' | 'compressed' | 'unknown';
+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;
+  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.
@@ -32,7 +45,10 @@ export declare const formatFile: (file: File) => FormattedFile;
  * @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;
+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.

package/utils/convertJsonImage.util.d.ts

@@ -1,3 +1,5 @@
-import { JSONContent } from '.././components/editor/Editor.vue.d';
-declare const convertJsonImage: (content: JSONContent | JSONContent[]) => JSONContent | JSONContent[];
+import { JSONContent } from '../components/editor/Editor.vue.d';
+declare const convertJsonImage: (
+  content: JSONContent | JSONContent[],
+) => JSONContent | JSONContent[];
 export default convertJsonImage;

package/utils/date.util.d.ts

@@ -1,34 +1,64 @@
-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, useGeneralSettings?: boolean) => string;
+export declare const formatDate: (
+  date: Date,
+  options?: DateOptions,
+  useGeneralSettings?: boolean,
+) => string;
 export declare const formatISODate: (date: string | Date) => string;
 /**
  * Formats a date to human readable form (timeago / relative time from now).
@@ -37,10 +67,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/exportToExcel.util.d.ts

@@ -1,20 +1,27 @@
+import { ButtonDownloadLocaleConfig } from '../components/buttondownload/ButtonDownload.vue.d';
+import {
+  Data,
+  DataTableLocaleConfig,
+  TableColumn,
+} from '../components/datatable/DataTable.vue.d';
+import { LocaleConfig } from '../plugins/WangsVue';
 export interface ITable {
-    headers: string[];
-    data: Record<string, unknown>[];
-    tableName: string;
-    tableTitle?: string;
+  headers: string[];
+  data: Record<string, unknown>[];
+  tableName?: string;
+  tableTitle?: string;
 }
 interface IExcelOptions {
-    tables: ITable[];
-    fileName: string;
-    additionalTexts?: (string | string[])[];
+  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;
+export declare const exportToExcel: (options: IExcelOptions) => Promise<void>;
+export declare const normalizeTableData: (
+  data?: Data[],
+  includedColumns?: TableColumn[],
+  locale?: (DataTableLocaleConfig | ButtonDownloadLocaleConfig) & {
+    global: LocaleConfig['global'];
+  },
+) => Record<string, unknown>[];
+export {};

package/utils/genPlaceholder.util.d.ts

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

package/utils/getProjectPermission.util.d.ts

@@ -1,4 +1,7 @@
 import { Project, Teams } from '../types/project.type';
 import { RoleMemberPermission } from '../types/roleDetailAccess.type';
-declare const getProjectPermission: (project?: Project, leaders?: Teams[]) => RoleMemberPermission;
+declare const getProjectPermission: (
+  project?: Project,
+  leaders?: Teams[],
+) => RoleMemberPermission;
 export default getProjectPermission;

package/utils/getSalesRole.util.d.ts

@@ -1,30 +1,30 @@
 export type SalesRole = {
-    sales: boolean;
-    seniorSales: boolean;
-    admin: boolean;
-    elsa: boolean;
-    licenseTrial: boolean;
-    incentive: boolean;
-    priceInformation: boolean;
-    referenceNumber: boolean;
-    manageDistributor: boolean;
-    managePartner: boolean;
-    manageProduct: boolean;
-    settingsUser: boolean;
-    settingsApproval: boolean;
-    settingsRole: boolean;
-    settingsExpiredTime: boolean;
-    settingsPPN: boolean;
-    settingsCustomField: boolean;
-    settingsTermAndCondition: boolean;
-    approvalProduct: boolean;
-    approvalLicenseTrial: boolean;
-    approvalSPRF: boolean;
-    approvalQuotation: boolean;
-    approvalBillingForm: boolean;
-    approvalCashback: boolean;
-    approvalElsa: boolean;
-    approvalQRF: boolean;
+  sales: boolean;
+  seniorSales: boolean;
+  admin: boolean;
+  elsa: boolean;
+  licenseTrial: boolean;
+  incentive: boolean;
+  priceInformation: boolean;
+  referenceNumber: boolean;
+  manageDistributor: boolean;
+  managePartner: boolean;
+  manageProduct: boolean;
+  settingsUser: boolean;
+  settingsApproval: boolean;
+  settingsRole: boolean;
+  settingsExpiredTime: boolean;
+  settingsPPN: boolean;
+  settingsCustomField: boolean;
+  settingsTermAndCondition: boolean;
+  approvalProduct: boolean;
+  approvalLicenseTrial: boolean;
+  approvalSPRF: boolean;
+  approvalQuotation: boolean;
+  approvalBillingForm: boolean;
+  approvalCashback: boolean;
+  approvalElsa: boolean;
+  approvalQRF: boolean;
 };
 declare const getSalesRole: () => SalesRole;
 export default getSalesRole;

package/utils/index.d.ts

@@ -1,5 +1,21 @@
-export * from '.././utils';
+export type * from '../utils/toast.util';
+export type * from '../utils/date.util';
+export type * from '../utils/addAttachment.util';
 export { queryParamsStringfy } from './queryParamsStringfy.util';
+export { getNestedPropertyValue } from '../utils/object.util';
+export {
+  formatDate,
+  formatISODate,
+  formatDateReadable,
+} from '../utils/date.util';
+export { checkRouteAccess } from '../utils/role.util';
+export { exportToExcel } from '../utils/exportToExcel.util';
+export {
+  formatFile,
+  getFileType,
+  validateFileSize,
+  validateFileType,
+} from '../utils/addAttachment.util';
 export { default as getSalesRole } from './getSalesRole.util';
 export { default as getStatusSeverity } from './statusSeverity.util';
 export { default as getUser } from './getUser.util';
@@ -8,16 +24,3 @@ export { default as getProjectPermission } from './getProjectPermission.util';
 export { default as isIntersect } from './isIntersect';
 export { default as convertJsonImage } from './convertJsonImage.util';
 export { default as useToast } from './toast.util';
-export * from './addAttachment.util';
-export * from './object.util';
-export * from './date.util';
-export type { ToastParams, ToastMethod, UseToastConfig } from './toast.util';
-export type { ITable } from './exportToExcel.util';
-export { default as exportToExcel } from './exportToExcel.util';
-export { default as useToast } from './toast.util';
-export { default as getAttachmentIcon } from './getAttachmentIcon.util';
-export { default as filterOptions } from './filterOptions.util';
-export { default as mergePropsWithDefaults } from './mergePropsWithDefaults.util';
-export { formatUserName, getInititalName } from './textFormatter.util';
-export { genPlaceholder } from './genPlaceholder.util';
-export { checkRouteAccess } from './role.util';

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/queryParamsStringfy.util.d.ts

@@ -1,7 +1,9 @@
-import { QueryParams } from '.././components/datatable/DataTable.vue.d';
+import { QueryParams } from '../components/datatable/DataTable.vue.d';
 import { QueryParamsStringfy } from '../types/queryParamsStringfy.type';
 /**
  * This Function will turn all array query params to string
  * using JSON Stringfy
  */
-export declare const queryParamsStringfy: (data: QueryParams | undefined) => QueryParamsStringfy | undefined;
+export declare const queryParamsStringfy: (
+  data: QueryParams | undefined,
+) => QueryParamsStringfy | undefined;

package/utils/role.util.d.ts

@@ -1,2 +1,6 @@
 import { NavigationGuardNext, RouteLocationNormalized } from 'vue-router';
-export declare const checkRouteAccess: (to: RouteLocationNormalized, from: RouteLocationNormalized, next: NavigationGuardNext) => void;
+export declare const checkRouteAccess: (
+  to: RouteLocationNormalized,
+  from: RouteLocationNormalized,
+  next: NavigationGuardNext,
+) => void;

package/utils/statusSeverity.util.d.ts

@@ -1,3 +1,5 @@
-import { BadgeProps } from '.././components/badge/Badge.vue.d';
+import { BadgeProps } from '../components/badge/Badge.vue.d';
 import { WangsitStatus } from '../types/wangsStatus.type';
-export default function getStatusSeverity(status: WangsitStatus): BadgeProps['severity'];
+export default function getStatusSeverity(
+  status: WangsitStatus,
+): BadgeProps['severity'];

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/xlsx.util.d.ts

@@ -0,0 +1,19 @@
+import * as XLSX from 'xlsx/types/index';
+/**
+ * Dynamically loads SheetJS (XLSX) from a CDN to avoid bundling its large package size.
+ *
+ * SheetJS is a powerful but heavy library (~700KB+ uncompressed). To improve bundle performance and reduce initial
+ * JavaScript payload, we load it only when needed (on demand), directly from a CDN.
+ *
+ * The official CDN build is a UMD module that exposes the `XLSX` object on the global `window`.
+ * This function ensures it's loaded once and cached for subsequent use.
+ *
+ * @returns {Promise<XLSXType>} A promise that resolves with the XLSX object once the script is loaded.
+ */
+declare const loadSheetJSFromCDN: () => Promise<typeof XLSX>;
+export default loadSheetJSFromCDN;
+declare global {
+  interface Window {
+    XLSX: typeof XLSX;
+  }
+}