@gemafajarramadhan/dynamic-ui 1.0.3 → 1.0.4

package/dist/index.d.ts

@@ -1,5 +1,45 @@
 declare module '@gemafajarramadhan/dynamic-ui' {
-    import type { DefineComponent, Plugin } from 'vue'
+    import type { DefineComponent, Plugin, App } from 'vue'
+
+    // ─── API Configuration ────────────────────────────────────────────────────────
+
+    /**
+     * Konfigurasi API untuk komponen DCode yang melakukan HTTP request.
+     * Di-set via: app.use(DynamicUI, config) atau setApiConfig(config)
+     */
+    export interface DynamicUIApiConfig {
+        /** Base URL untuk semua request API. Contoh: 'https://api.example.com' */
+        apiBaseUrl?: string
+        /**
+         * Fungsi untuk mendapatkan token auth terkini.
+         * Dipanggil setiap kali ada request, sehingga mendukung token refresh.
+         * @example () => localStorage.getItem('access_token')
+         * @example () => store.getters['auth/token']
+         */
+        getAuthToken?: () => string | null | undefined
+        /**
+         * Fungsi untuk menyediakan custom HTTP headers.
+         * Jika disediakan, akan di-merge dengan default headers.
+         * @example () => ({ Authorization: `Bearer ${store.state.token}`, 'X-Tenant': 'abc' })
+         */
+        getHeaders?: () => Record<string, string>
+        /**
+         * Callback yang dipanggil ketika response HTTP 401 diterima.
+         * Berguna untuk trigger logout atau redirect ke halaman login.
+         * @example () => router.push('/login')
+         */
+        onUnauthorized?: () => void
+    }
+
+    /**
+     * Set konfigurasi API secara manual (tanpa app.use).
+     * Berguna untuk setup di luar Vue app (misal: sebelum createApp).
+     *
+     * @example
+     * import { setApiConfig } from '@gemafajarramadhan/dynamic-ui'
+     * setApiConfig({ apiBaseUrl: 'https://api.example.com' })
+     */
+    export function setApiConfig(config: DynamicUIApiConfig): void
 
     // ─── Base Components ─────────────────────────────────────────────────────────
 
@@ -266,6 +306,22 @@ declare module '@gemafajarramadhan/dynamic-ui' {
 
     // ─── Vue Plugin ──────────────────────────────────────────────────────────────
 
-    declare const DynamicUI: Plugin
+    /**
+     * Vue Plugin - install semua DCode components secara global.
+     *
+     * @example
+     * import DynamicUI from '@gemafajarramadhan/dynamic-ui'
+     * import '@gemafajarramadhan/dynamic-ui/style.css'
+     *
+     * app.use(DynamicUI, {
+     *   apiBaseUrl: 'https://api.example.com',
+     *   getAuthToken: () => localStorage.getItem('access_token'),
+     *   getHeaders: () => ({ Authorization: `Bearer ${store.state.token}` }),
+     *   onUnauthorized: () => router.push('/login'),
+     * })
+     */
+    declare const DynamicUI: {
+        install(app: App, options?: DynamicUIApiConfig): void
+    }
     export default DynamicUI
 }