@skyworx/dynamic-ui 1.0.19 → 1.0.20

package/dist/types/types/index.d.ts

@@ -0,0 +1,149 @@
+export interface User {
+    id: number;
+    email: string;
+    name: string;
+    role: string | 'admin' | 'manager' | 'staff';
+    avatar?: string;
+    username?: string;
+    menu?: any[];
+}
+export interface LoginCredentials {
+    email: string;
+    password: string;
+}
+export interface AuthResponse {
+    token: string;
+    user: User;
+}
+export interface Customer {
+    id: string;
+    customerId: string;
+    name: string;
+    email: string;
+    phone: string;
+    accountNumber: string;
+    balance: number;
+    status: 'active' | 'inactive' | 'blocked';
+    createdAt: string;
+    address: string;
+    idNumber: string;
+}
+export interface Transaction {
+    id: string;
+    transactionId: string;
+    type: 'credit' | 'debit';
+    amount: number;
+    description: string;
+    status: 'success' | 'pending' | 'failed';
+    timestamp: string;
+    accountNumber: string;
+    customerName: string;
+    reference?: string;
+}
+export interface DashboardSummary {
+    totalCustomers: number;
+    totalBalance: number;
+    todayTransactions: number;
+    failedTransactions: number;
+    customerGrowth: number;
+    balanceGrowth: number;
+    transactionGrowth: number;
+}
+export interface ChartData {
+    labels: string[];
+    datasets: {
+        label: string;
+        data: number[];
+        backgroundColor?: string | string[];
+        borderColor?: string | string[];
+        borderWidth?: number;
+        tension?: number;
+        fill?: boolean;
+    }[];
+}
+export interface TableColumn {
+    key: string;
+    label: string;
+    align?: 'left' | 'center' | 'right';
+    width?: string;
+    format?: (value: any) => string;
+    sortable?: boolean;
+    type?: 'text' | 'badge' | any;
+    condition?: {
+        value: any;
+        color?: string;
+        variant?: string;
+        label?: string;
+        labelID?: string;
+        labelEN?: string;
+        labelKR?: string;
+        class?: string;
+        logic?: any;
+        conditionRule?: any;
+    }[];
+    keyCheckbox?: string;
+    keyPayload?: string;
+    propsCustom?: any[];
+    buttons?: any[];
+    props?: Record<string, any>;
+    isHidden?: boolean;
+    custom?: {
+        type?: string;
+        propsCustom?: any[];
+        props?: Record<string, any>;
+        buttons?: any[];
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+export interface SortConfig {
+    key: string;
+    direction: 'asc' | 'desc';
+}
+export interface PaginationConfig {
+    currentPage: number;
+    perPage: number;
+    totalItems: number;
+    totalPages: number;
+}
+export interface ApiResponse<T> {
+    success: boolean;
+    data: T;
+    message?: string;
+    error?: string;
+}
+export interface Notification {
+    id: string;
+    type: 'info' | 'success' | 'warning' | 'error';
+    title: string;
+    message: string;
+    read: boolean;
+    timestamp: string;
+}
+export interface MenuItem {
+    id: string;
+    label: string;
+    icon: string;
+    route: string;
+    badge?: number;
+    children?: MenuItem[];
+}
+export interface DatatableConfig {
+    id: number;
+    code: string;
+    titleID: string;
+    titleEN: string;
+    titleKR?: string;
+    descriptionID: string;
+    descriptionEN: string;
+    descriptionKR?: string;
+    pagination: boolean;
+    action?: any[];
+    actionGlobal?: any[];
+    headers: any[];
+    filter?: any[];
+    filters?: any[];
+    endpoint?: any;
+    endpointGlobal?: any;
+    payload?: any;
+}

package/dist/types/utils/action.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const isActionDisabled: (action: any, selectedCount: number) => boolean;
+export declare const disableButtonsBySelection: (buttons: any[] | undefined, selectedCount: number) => any[];

package/dist/types/utils/action.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/datePIckerColor.d.ts

@@ -0,0 +1,8 @@
+import { type Ref } from "vue";
+export type Tone = "primary" | "emerald" | "amber" | "violet" | "destructive";
+export declare function applyVueDatePickerToneForced(tone: Tone, styleId?: string): void;
+export declare function useVueDatePickerToneForced(toneRef: Ref<Tone>, styleId?: string): void;
+/** ✅ Button shadcn: tone -> variant */
+export type ShadcnVariant = "default" | "outline" | "destructive" | "outline-destructive" | "emerald" | "amber" | "violet" | "outline-emerald" | "outline-amber" | "outline-violet";
+export declare function getSelectVariantByTone(tone: Tone): ShadcnVariant;
+export declare function getCancelVariantByTone(tone: Tone): ShadcnVariant;

package/dist/types/utils/download.utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Download helpers shared by DataTable and useFormActions.
+ *
+ * Why this exists: a host `apiUrl` may resolve with a bare Blob, in which case response
+ * headers (notably Content-Disposition) are gone and the filename is unrecoverable. So when
+ * a download comes back as JSON we cannot trust the MIME type alone to tell a real file
+ * from an error envelope - we look at the payload shape instead.
+ */
+/**
+ * Reads at most `limit` bytes from a blob and parses them as JSON.
+ * Returns null when the blob is not JSON, is truncated mid-structure, or is empty.
+ */
+export declare const parseJsonHead: (blob: Blob, limit?: number) => Promise<any | null>;
+/**
+ * True when parsed JSON looks like an API error envelope rather than exported data.
+ *
+ * Array roots are always treated as data - exports are commonly arrays of records.
+ * Objects qualify when they carry an explicit failure flag or an error key, or when
+ * they are small enough and have a `message` (typical `{ message: "..." }` envelope).
+ */
+export declare const isErrorEnvelope: (data: any) => boolean;
+/**
+ * Best-effort human readable message from an error envelope.
+ */
+export declare const errorEnvelopeMessage: (data: any, fallback: string) => string;
+/**
+ * True when the server (or schema) already declared this response as a downloadable file,
+ * so a JSON body must not be second-guessed as an error.
+ */
+export declare const serverSaidFile: (headerFilename: string | null | undefined, contentDisposition: string | null | undefined, responseType?: string) => boolean;

package/dist/types/utils/download.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/formdata.utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Multipart helpers shared by DataTable and useDynamicForm.
+ *
+ * Why this exists: endpoints that take a file reject a JSON body with HTTP 415.
+ * `JSON.stringify(new File(...))` yields `{}`, so the upload is lost even when the
+ * server tolerates the content type. Any payload holding a File/Blob must be
+ * wrapped in FormData before it reaches `apiUrl`, and the Content-Type header must
+ * be dropped so the browser can append its own multipart boundary.
+ */
+/**
+ * Robust check for File/Blob objects, even if proxied or from different contexts.
+ * Also matches plain descriptors such as `{ name, size }` sent by third-party inputs.
+ */
+export declare const isFileObject: (val: any) => boolean;
+/**
+ * True when any top-level value in the payload is a File/Blob, meaning the request
+ * has to go out as multipart instead of JSON.
+ */
+export declare const hasFile: (payload: Record<string, any> | null | undefined) => boolean;
+/**
+ * Flattens a payload into FormData. Nullish values are dropped; arrays are appended
+ * once per element so repeated keys stay repeated, matching how `apiUrl` serialises
+ * JSON arrays.
+ */
+export declare const toFormData: (payload: Record<string, any>) => FormData;
+/**
+ * Wraps the payload in FormData when it carries a file and the method can carry a
+ * body, otherwise returns it untouched. Content-Type is dropped from `config` so the
+ * host does not force a boundary-less JSON content type. Headers are copied rather
+ * than mutated in place, because `config` often originates from a schema prop.
+ */
+export declare const buildMultipartBody: (payload: Record<string, any>, apiMethod: string | undefined, config: Record<string, any>) => Record<string, any> | FormData;

package/dist/types/utils/formdata.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/helpers.d.ts

@@ -0,0 +1,38 @@
+export declare const formatCurrency: (amount: number) => string;
+/**
+ * Enhanced currency formatter using currency.js
+ * Supports IDR, USD, EUR
+ */
+export declare const formatByCurrency: (value: any, currencyCode?: string) => string;
+export declare const formatTanggalIndonesia: (date: Date | string | number, withDay?: boolean) => string;
+export declare const formatDate: (date: string | Date, format?: "short" | "long" | "time" | "datetime", locale?: string) => string;
+export declare const formatCustomDate: (date: string | Date, formatStr: string) => string;
+export declare const formatAccountNumber: (accountNumber: string) => string;
+export declare const generateId: () => string;
+export declare const debounce: <T extends (...args: any[]) => any>(func: T, delay: number) => ((...args: Parameters<T>) => void);
+export declare const isValidEmail: (email: string) => boolean;
+export declare const calculatePercentageChange: (current: number, previous: number) => number;
+export declare const getInitials: (name: string) => string;
+export declare const sleep: (ms: number) => Promise<void>;
+export declare const storage: {
+    get: <T>(key: string) => T | null;
+    set: <T>(key: string, value: T) => void;
+    remove: (key: string) => void;
+    clear: () => void;
+};
+export declare const cloneDeep: <T>(val: T) => T;
+export declare const copyToClipboard: (text: string) => Promise<void>;
+export type FieldSize = "sm" | "default" | "lg";
+export type Rounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "full";
+export declare const roundedClass: (r?: Rounded | string) => string;
+export declare const fieldSizeClass: (s?: FieldSize) => "h-8 px-2.5 text-sm" | "h-11 px-3.5 text-base" | "h-10 px-3 text-sm";
+export declare const resolveLucideIcon: (iconName: string | undefined | null, lucideIcons: Record<string, any>) => any;
+/**
+ * Resolve a menu icon string to a Lucide component.
+ *
+ * Accepts Lucide names ("Home", "user-cog") as well as legacy MDI font classes
+ * ("mdi-view-dashboard", "mdi mdi-account-group") and maps them to their closest
+ * Lucide equivalent. Returns `null` when nothing matches, so callers can fall back
+ * (e.g. to a monogram) instead of rendering an empty box.
+ */
+export declare const resolveMenuIcon: (iconName: string | undefined | null, lucideIcons: Record<string, any>) => any;

package/dist/types/utils/inFlightFetch.d.ts

@@ -0,0 +1 @@
+export declare function shareDetailGet(method: string, url: string, params: any, run: () => Promise<any>): Promise<any>;

package/dist/types/utils/inFlightFetch.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/utils/permission.d.ts

@@ -0,0 +1,17 @@
+export declare function getUserData(): any;
+/**
+ * Get user permissions/menu from localStorage
+ */
+export declare function getUserPermissions(): any;
+/**
+ * Check if user has access to a specific route
+ */
+export declare function hasRouteAccess(routePath: string): boolean;
+/**
+ * Check if user has access to a specific action on a route
+ */
+export declare function hasActionAccess(routePath: string, actionCode: string): boolean;
+/**
+ * Check if route exists in user menu structure (regardless of permission)
+ */
+export declare function routeExistsInMenu(routePath: string): boolean;

package/dist/types/utils/range.utils.d.ts

@@ -0,0 +1,22 @@
+export declare const RANGE_SEPARATOR = " - ";
+export declare const hasRangeSeparator: (value: unknown) => boolean;
+/**
+ * Split a serialized range ("10 - 20") into its two sides.
+ * A plain value with no separator is treated as the lower bound.
+ */
+export declare const parseRange: (value: unknown) => [string, string];
+/**
+ * Join the two bounds back into the single string the API stores.
+ * Returns null when both sides are empty so the field clears instead of
+ * submitting "".
+ */
+export declare const formatRange: (from: unknown, to: unknown) => string | null;
+export declare const isRangeInverted: (from: unknown, to: unknown) => boolean;
+/**
+ * Whether to raise the order error. `isRangeInverted` answers a mathematical
+ * question, this answers the product one: an inverted range is only a mistake
+ * when the field opts into the guard, because "21 - 10" is a legitimate value
+ * for a window, a scoring band or a delta. Off by default, and a rangeRule that
+ * predates the flag is treated as off so no saved schema starts failing.
+ */
+export declare const shouldFlagInvertedRange: (from: unknown, to: unknown, enforceOrder?: boolean) => boolean;

package/dist/types/utils/range.utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyworx/dynamic-ui",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "Vue 3 Dynamic UI Component Library - Compatible with Vue, React, Angular, and any other framework via Web Components",
   "type": "module",
   "license": "MIT",
@@ -30,6 +30,7 @@
     "build:types": "vue-tsc -p tsconfig.build.json && node scripts/gen-types-entry.mjs",
     "build:webcomponent": "cross-env BUILD_MODE=webcomponent vite build --outDir dist/webcomponents",
     "build:all": "npm run build:lib && npm run build:webcomponent",
+    "prepublishOnly": "npm run build",
     "preview": "vite preview",
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",