@gemafajarramadhan/dynamic-ui 1.0.2 → 1.0.4

package/dist/webcomponents/vite.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gemafajarramadhan/dynamic-ui",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Vue 3 Dynamic UI Component Library - Compatible with Vue, React, Angular, and any other framework via Web Components",
   "type": "module",
   "license": "MIT",

package/src/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
 }