@goplusvn/core 0.1.0

package/dist/utils/index.d.mts

@@ -0,0 +1,205 @@
+import { ClassValue } from 'clsx';
+import { NavigationType, DynamicIconNameType, LocaleType, FormatStyleType } from '../types/index.mjs';
+export { S as STATUS_ACTIVE, a as STATUS_COLORS, b as STATUS_INACTIVE, c as STATUS_OPTIONS, d as STATUS_VALUES, e as booleanToStatus, s as statusToBoolean } from '../status-BOXZgIqX.mjs';
+import 'lucide-react';
+import 'react';
+import 'zod';
+
+/**
+ * Merge Tailwind CSS classes with clsx
+ */
+declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Get initials from full name
+ */
+declare function getInitials(fullName: string): string;
+/**
+ * Slugify string
+ */
+declare function slugify(text: string): string;
+/**
+ * Convert camelCase to Title Case
+ */
+declare function camelCaseToTitleCase(camelCaseStr: string): string;
+/**
+ * Convert Title Case to camelCase
+ */
+declare function titleCaseToCamelCase(titleCaseStr: string): string;
+declare const isEven: (num: number) => boolean;
+declare const isNonNegative: (num: number) => boolean;
+/**
+ * Đọc số tiền thành chữ tiếng Việt
+ * Dùng chung cho tất cả các phiếu in (hợp đồng, phiếu thu, phiếu chi, phiếu nhập/xuất kho, v.v.)
+ * @param amount - Số tiền (VND)
+ * @returns Chuỗi đọc bằng chữ, VD: "Bảy mươi hai triệu một trăm năm mươi chín nghìn tám trăm hai mươi đồng"
+ */
+declare function readMoney(amount: number): string;
+/**
+ * Format currency with locale
+ */
+declare function formatCurrency(value: number, locales?: LocaleType, currency?: string): string;
+/**
+ * Format number with locale
+ */
+declare function formatNumber(value: number, options?: {
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}): string;
+/**
+ * Format percent
+ */
+declare function formatPercent(value: number, locales?: LocaleType): string;
+/**
+ * Format number to compact (e.g., 1K, 1M)
+ */
+declare function formatNumberToCompact(value: number, locales?: LocaleType): string;
+/**
+ * Format file size
+ */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * Format unread count
+ */
+declare function formatUnreadCount(unreadCount: number): string | number;
+/**
+ * Format date with Vietnamese locale (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDate(date: Date | string, options?: {
+    locale?: string;
+    format?: "short" | "medium" | "long" | "full";
+}): string;
+/**
+ * Format datetime with Vietnamese locale (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDateTime(date: Date | string, options?: {
+    locale?: string;
+}): string;
+/**
+ * Format relative date (Today, Yesterday, or date) - Asia/Ho_Chi_Minh timezone
+ */
+declare function formatRelativeDate(value?: string | number | Date): string;
+/**
+ * Check if date is before today (Asia/Ho_Chi_Minh timezone)
+ */
+declare function isBeforeToday(date: Date): boolean;
+/**
+ * Ensure path has prefix
+ */
+declare function ensureWithPrefix(value: string, prefix: string): string;
+/**
+ * Ensure path has suffix
+ */
+declare function ensureWithSuffix(value: string, suffix: string): string;
+/**
+ * Ensure path without prefix
+ */
+declare function ensureWithoutPrefix(value: string, prefix: string): string;
+/**
+ * Ensure path without suffix
+ */
+declare function ensureWithoutSuffix(value: string, suffix: string): string;
+/**
+ * Check if pathname is active
+ */
+declare function isActivePathname(basePathname: string, currentPathname: string, exactMatch?: boolean): boolean;
+/**
+ * Wait/sleep function
+ */
+declare function wait(ms?: number): Promise<void>;
+/**
+ * Debounce function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Deep clone object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if value is empty
+ */
+declare function isEmpty(value: unknown): boolean;
+/**
+ * Generate a random ID
+ */
+declare function generateId(prefix?: string): string;
+/**
+ * Get dictionary value safely
+ */
+declare function getDictionaryValue(key: string, section: Record<string, unknown>, fallback?: string): string;
+/**
+ * Format overview card value based on style
+ */
+declare function formatOverviewCardValue(value: number, formatStyle: FormatStyleType): string | number;
+/**
+ * Get credit card brand name from number
+ */
+declare function getCreditCardBrandName(number: string): string;
+/**
+ * Convert rem to pixels
+ */
+declare function remToPx(rem: number): number;
+/**
+ * Check if string is a valid URL
+ */
+declare function isUrl(text: string): boolean;
+/**
+ * Rating to percentage string
+ */
+declare function ratingToPercentage(rating: number, maxRating: number, fractionDigits?: number): string;
+/**
+ * Ensure redirect pathname with query params
+ */
+declare function ensureRedirectPathname(basePathname: string, redirectPathname: string): string;
+/**
+ * Get discounted price
+ */
+declare function getDiscountedPrice(price: number, discountRate: number, isAnnual?: boolean): number;
+/**
+ * Convert time string to Date
+ */
+declare function timeToDate(timeString: string, baseDate?: Date): Date;
+/**
+ * Format file type
+ */
+declare function formatFileType(type: string): string;
+/**
+ * Format date with time (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDateWithTime(value: string | number | Date): string;
+/**
+ * Format date short (MMM dd) - Asia/Ho_Chi_Minh timezone
+ */
+declare function formatDateShort(value: string | number | Date): string;
+/**
+ * Format time (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatTime(value: string | number | Date): string;
+/**
+ * Format duration from milliseconds
+ */
+declare function formatDuration(value: string | number | Date): string;
+/**
+ * Format distance to now
+ */
+declare function formatDistance(value: string | number | Date): string;
+
+declare function isPathnameMissingLocale(pathname: string): boolean;
+declare function getLocaleFromPathname(pathname: string): string | undefined;
+declare function ensureLocalizedPathname(pathname: string, locale: string): string;
+declare function relocalizePathname(pathname: string, locale: string): string;
+declare class Logger {
+    private log;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: unknown, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+declare const logger: Logger;
+
+declare function shouldExcludeFromTabs(pathname: string): boolean;
+declare function normalizePathname(pathname: string): string;
+declare function findRouteTitle(pathname: string, navigations: NavigationType[]): string | null;
+declare function findRouteIcon(pathname: string, navigations: NavigationType[]): DynamicIconNameType | null;
+
+export { camelCaseToTitleCase, cn, debounce, deepClone, ensureLocalizedPathname, ensureRedirectPathname, ensureWithPrefix, ensureWithSuffix, ensureWithoutPrefix, ensureWithoutSuffix, findRouteIcon, findRouteTitle, formatCurrency, formatDate, formatDateShort, formatDateTime, formatDateWithTime, formatDistance, formatDuration, formatFileSize, formatFileType, formatNumber, formatNumberToCompact, formatOverviewCardValue, formatPercent, formatRelativeDate, formatTime, formatUnreadCount, generateId, getCreditCardBrandName, getDictionaryValue, getDiscountedPrice, getInitials, getLocaleFromPathname, isActivePathname, isBeforeToday, isEmpty, isEven, isNonNegative, isPathnameMissingLocale, isUrl, logger, normalizePathname, ratingToPercentage, readMoney, relocalizePathname, remToPx, shouldExcludeFromTabs, slugify, timeToDate, titleCaseToCamelCase, wait };

package/dist/utils/index.d.ts

@@ -0,0 +1,205 @@
+import { ClassValue } from 'clsx';
+import { NavigationType, DynamicIconNameType, LocaleType, FormatStyleType } from '../types/index.js';
+export { S as STATUS_ACTIVE, a as STATUS_COLORS, b as STATUS_INACTIVE, c as STATUS_OPTIONS, d as STATUS_VALUES, e as booleanToStatus, s as statusToBoolean } from '../status-BOXZgIqX.js';
+import 'lucide-react';
+import 'react';
+import 'zod';
+
+/**
+ * Merge Tailwind CSS classes with clsx
+ */
+declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Get initials from full name
+ */
+declare function getInitials(fullName: string): string;
+/**
+ * Slugify string
+ */
+declare function slugify(text: string): string;
+/**
+ * Convert camelCase to Title Case
+ */
+declare function camelCaseToTitleCase(camelCaseStr: string): string;
+/**
+ * Convert Title Case to camelCase
+ */
+declare function titleCaseToCamelCase(titleCaseStr: string): string;
+declare const isEven: (num: number) => boolean;
+declare const isNonNegative: (num: number) => boolean;
+/**
+ * Đọc số tiền thành chữ tiếng Việt
+ * Dùng chung cho tất cả các phiếu in (hợp đồng, phiếu thu, phiếu chi, phiếu nhập/xuất kho, v.v.)
+ * @param amount - Số tiền (VND)
+ * @returns Chuỗi đọc bằng chữ, VD: "Bảy mươi hai triệu một trăm năm mươi chín nghìn tám trăm hai mươi đồng"
+ */
+declare function readMoney(amount: number): string;
+/**
+ * Format currency with locale
+ */
+declare function formatCurrency(value: number, locales?: LocaleType, currency?: string): string;
+/**
+ * Format number with locale
+ */
+declare function formatNumber(value: number, options?: {
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}): string;
+/**
+ * Format percent
+ */
+declare function formatPercent(value: number, locales?: LocaleType): string;
+/**
+ * Format number to compact (e.g., 1K, 1M)
+ */
+declare function formatNumberToCompact(value: number, locales?: LocaleType): string;
+/**
+ * Format file size
+ */
+declare function formatFileSize(bytes: number, decimals?: number): string;
+/**
+ * Format unread count
+ */
+declare function formatUnreadCount(unreadCount: number): string | number;
+/**
+ * Format date with Vietnamese locale (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDate(date: Date | string, options?: {
+    locale?: string;
+    format?: "short" | "medium" | "long" | "full";
+}): string;
+/**
+ * Format datetime with Vietnamese locale (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDateTime(date: Date | string, options?: {
+    locale?: string;
+}): string;
+/**
+ * Format relative date (Today, Yesterday, or date) - Asia/Ho_Chi_Minh timezone
+ */
+declare function formatRelativeDate(value?: string | number | Date): string;
+/**
+ * Check if date is before today (Asia/Ho_Chi_Minh timezone)
+ */
+declare function isBeforeToday(date: Date): boolean;
+/**
+ * Ensure path has prefix
+ */
+declare function ensureWithPrefix(value: string, prefix: string): string;
+/**
+ * Ensure path has suffix
+ */
+declare function ensureWithSuffix(value: string, suffix: string): string;
+/**
+ * Ensure path without prefix
+ */
+declare function ensureWithoutPrefix(value: string, prefix: string): string;
+/**
+ * Ensure path without suffix
+ */
+declare function ensureWithoutSuffix(value: string, suffix: string): string;
+/**
+ * Check if pathname is active
+ */
+declare function isActivePathname(basePathname: string, currentPathname: string, exactMatch?: boolean): boolean;
+/**
+ * Wait/sleep function
+ */
+declare function wait(ms?: number): Promise<void>;
+/**
+ * Debounce function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+/**
+ * Deep clone object
+ */
+declare function deepClone<T>(obj: T): T;
+/**
+ * Check if value is empty
+ */
+declare function isEmpty(value: unknown): boolean;
+/**
+ * Generate a random ID
+ */
+declare function generateId(prefix?: string): string;
+/**
+ * Get dictionary value safely
+ */
+declare function getDictionaryValue(key: string, section: Record<string, unknown>, fallback?: string): string;
+/**
+ * Format overview card value based on style
+ */
+declare function formatOverviewCardValue(value: number, formatStyle: FormatStyleType): string | number;
+/**
+ * Get credit card brand name from number
+ */
+declare function getCreditCardBrandName(number: string): string;
+/**
+ * Convert rem to pixels
+ */
+declare function remToPx(rem: number): number;
+/**
+ * Check if string is a valid URL
+ */
+declare function isUrl(text: string): boolean;
+/**
+ * Rating to percentage string
+ */
+declare function ratingToPercentage(rating: number, maxRating: number, fractionDigits?: number): string;
+/**
+ * Ensure redirect pathname with query params
+ */
+declare function ensureRedirectPathname(basePathname: string, redirectPathname: string): string;
+/**
+ * Get discounted price
+ */
+declare function getDiscountedPrice(price: number, discountRate: number, isAnnual?: boolean): number;
+/**
+ * Convert time string to Date
+ */
+declare function timeToDate(timeString: string, baseDate?: Date): Date;
+/**
+ * Format file type
+ */
+declare function formatFileType(type: string): string;
+/**
+ * Format date with time (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatDateWithTime(value: string | number | Date): string;
+/**
+ * Format date short (MMM dd) - Asia/Ho_Chi_Minh timezone
+ */
+declare function formatDateShort(value: string | number | Date): string;
+/**
+ * Format time (Asia/Ho_Chi_Minh timezone)
+ */
+declare function formatTime(value: string | number | Date): string;
+/**
+ * Format duration from milliseconds
+ */
+declare function formatDuration(value: string | number | Date): string;
+/**
+ * Format distance to now
+ */
+declare function formatDistance(value: string | number | Date): string;
+
+declare function isPathnameMissingLocale(pathname: string): boolean;
+declare function getLocaleFromPathname(pathname: string): string | undefined;
+declare function ensureLocalizedPathname(pathname: string, locale: string): string;
+declare function relocalizePathname(pathname: string, locale: string): string;
+declare class Logger {
+    private log;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, error?: unknown, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+declare const logger: Logger;
+
+declare function shouldExcludeFromTabs(pathname: string): boolean;
+declare function normalizePathname(pathname: string): string;
+declare function findRouteTitle(pathname: string, navigations: NavigationType[]): string | null;
+declare function findRouteIcon(pathname: string, navigations: NavigationType[]): DynamicIconNameType | null;
+
+export { camelCaseToTitleCase, cn, debounce, deepClone, ensureLocalizedPathname, ensureRedirectPathname, ensureWithPrefix, ensureWithSuffix, ensureWithoutPrefix, ensureWithoutSuffix, findRouteIcon, findRouteTitle, formatCurrency, formatDate, formatDateShort, formatDateTime, formatDateWithTime, formatDistance, formatDuration, formatFileSize, formatFileType, formatNumber, formatNumberToCompact, formatOverviewCardValue, formatPercent, formatRelativeDate, formatTime, formatUnreadCount, generateId, getCreditCardBrandName, getDictionaryValue, getDiscountedPrice, getInitials, getLocaleFromPathname, isActivePathname, isBeforeToday, isEmpty, isEven, isNonNegative, isPathnameMissingLocale, isUrl, logger, normalizePathname, ratingToPercentage, readMoney, relocalizePathname, remToPx, shouldExcludeFromTabs, slugify, timeToDate, titleCaseToCamelCase, wait };