@fewangsit/wangsvue-fats 1.0.0-alpha.14 → 1.0.0-alpha.141

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;
+  }
+}