unipo-ui 1.0.2 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/{chunk-SVRTAYZW.cjs → chunk-DEF5CA7C.cjs} +22 -2
  2. package/dist/chunk-DEF5CA7C.cjs.map +1 -0
  3. package/dist/{chunk-2FW3QITF.js → chunk-SJ4DJOMZ.js} +21 -3
  4. package/dist/chunk-SJ4DJOMZ.js.map +1 -0
  5. package/dist/{content-f6eK74xx.d.cts → content-DaJPx5LX.d.cts} +6 -1
  6. package/dist/{content-f6eK74xx.d.ts → content-DaJPx5LX.d.ts} +6 -1
  7. package/dist/index.cjs +208 -175
  8. package/dist/index.cjs.map +1 -1
  9. package/dist/index.d.cts +17 -2
  10. package/dist/index.d.ts +17 -2
  11. package/dist/index.js +31 -6
  12. package/dist/index.js.map +1 -1
  13. package/dist/registry.json +103 -9
  14. package/dist/scss/components/_display.scss +46 -0
  15. package/dist/scss/components/_layout.scss +20 -0
  16. package/dist/scss/components/_overlays.scss +14 -1
  17. package/dist/siakad.cjs +1195 -783
  18. package/dist/siakad.cjs.map +1 -1
  19. package/dist/siakad.d.cts +306 -4
  20. package/dist/siakad.d.ts +306 -4
  21. package/dist/siakad.js +426 -23
  22. package/dist/siakad.js.map +1 -1
  23. package/dist/ui-unipo.css +77 -1
  24. package/dist/ui-unipo.min.css +1 -1
  25. package/package.json +2 -2
  26. package/src/components/galat.tsx +33 -0
  27. package/src/components/layout.tsx +42 -4
  28. package/src/index.ts +1 -0
  29. package/src/siakad/akademik.tsx +2 -1
  30. package/src/siakad/aplikasi.tsx +4 -2
  31. package/src/siakad/berkas.tsx +203 -0
  32. package/src/siakad/dasbor.tsx +4 -2
  33. package/src/siakad/galat.tsx +48 -0
  34. package/src/siakad/index.ts +3 -0
  35. package/src/siakad/kalender.tsx +3 -1
  36. package/src/siakad/kelengkapan.tsx +3 -1
  37. package/src/siakad/kurikulum.tsx +2 -1
  38. package/src/siakad/lms.tsx +2 -1
  39. package/src/siakad/log.tsx +7 -3
  40. package/src/siakad/pilih.tsx +321 -0
  41. package/src/siakad/provider.tsx +12 -3
  42. package/dist/chunk-2FW3QITF.js.map +0 -1
  43. package/dist/chunk-SVRTAYZW.cjs.map +0 -1
@@ -0,0 +1,321 @@
1
+ 'use client';
2
+ import * as React from 'react';
3
+ import { BookOpen, Briefcase, Building2, GraduationCap, Landmark, Network, UserRound, Users, UsersRound } from 'lucide-react';
4
+ import { Combobox, OptionContent } from '../components/select';
5
+ import type { ControlSize } from '../components/forms';
6
+ import { Avatar } from '../components/display';
7
+ import { useOptionalSiakad } from './provider';
8
+
9
+ type Baris = Record<string, unknown>;
10
+ const teks = (v: unknown) => (v == null ? '' : String(v));
11
+ const gabung = (...xs: unknown[]) => xs.filter((x) => x != null && x !== '').join(' · ');
12
+
13
+ /**
14
+ * Sumber data untuk {@link PilihEntitas}: endpoint daftar (dengan pencarian `q`), kolom yang menjadi nilai
15
+ * (ID/NIM/NIDN/username), dan cara menampilkan satu baris. Isi sendiri untuk tabel yang belum ada di
16
+ * {@link SUMBER_ENTITAS}, mis. dari katalog OpenAPI.
17
+ */
18
+ export interface SumberEntitas {
19
+ /** Nama tunggal untuk teks bantuan, mis. "mahasiswa", "organisasi mahasiswa". */
20
+ nama: string;
21
+ /** Endpoint daftar, mis. `/v1/kemahasiswaan/ormawa`. Harus menerima `q` dan `per_page` (kecuali `klien`). */
22
+ path: string;
23
+ /** Kolom baris yang menjadi nilai, mis. `id`, `nim`, `username`. */
24
+ kunci: string;
25
+ /** Endpoint satu data untuk menampilkan nilai awal, dengan `{id}`, mis. `/v1/mahasiswa/{id}`. */
26
+ satu?: string;
27
+ /** Bila tidak ada `satu`: parameter daftar untuk mencari nilai awal, mis. `username`. Bawaan `q`. */
28
+ saringKunci?: string;
29
+ /** Daftar kecil tanpa pencarian server: dimuat sekali, disaring di browser. */
30
+ klien?: boolean;
31
+ /** Parameter tetap untuk endpoint daftar. */
32
+ query?: Record<string, string | number | boolean | undefined>;
33
+ judul: (r: Baris) => string;
34
+ meta?: (r: Baris) => string;
35
+ /** Avatar inisial/foto (orang) atau ikon (lainnya). */
36
+ avatar?: boolean;
37
+ ikon?: React.ReactNode;
38
+ placeholder?: string;
39
+ }
40
+
41
+ /** Sumber bawaan. Kunci objek ini dipakai sebagai `jenis` di <PilihEntitas jenis="mahasiswa" />. */
42
+ export const SUMBER_ENTITAS = {
43
+ mahasiswa: {
44
+ nama: 'mahasiswa',
45
+ path: '/v1/mahasiswa',
46
+ kunci: 'nim',
47
+ satu: '/v1/mahasiswa/{id}',
48
+ judul: (r) => teks(r.nama),
49
+ meta: (r) => gabung(r.nim, r.nama_prodi, r.tahun_masuk),
50
+ avatar: true,
51
+ ikon: <GraduationCap />,
52
+ placeholder: 'Cari NIM atau nama mahasiswa',
53
+ },
54
+ dosen: {
55
+ nama: 'dosen',
56
+ path: '/v1/dosen',
57
+ kunci: 'nidn',
58
+ satu: '/v1/dosen/{id}',
59
+ judul: (r) => teks(r.nama_lengkap || r.nama),
60
+ meta: (r) => gabung(r.nidn && `NIDN ${r.nidn}`, r.jabatan_akademik, r.nama_prodi),
61
+ avatar: true,
62
+ ikon: <UserRound />,
63
+ placeholder: 'Cari NIDN atau nama dosen',
64
+ },
65
+ pegawai: {
66
+ nama: 'pegawai',
67
+ path: '/v1/sdm/pegawai',
68
+ kunci: 'id',
69
+ satu: '/v1/sdm/pegawai/{id}',
70
+ judul: (r) => teks(r.nama_lengkap || r.nama),
71
+ meta: (r) => gabung(r.nip && `NIP ${r.nip}`, r.nidn && `NIDN ${r.nidn}`, r.unit_nama),
72
+ avatar: true,
73
+ ikon: <Users />,
74
+ placeholder: 'Cari nama, NIP, atau NIDN pegawai',
75
+ },
76
+ /** Akun pengguna (user.username): mahasiswa, dosen, tendik, admin. */
77
+ pengguna: {
78
+ nama: 'pengguna',
79
+ path: '/v1/induk/orang',
80
+ kunci: 'username',
81
+ saringKunci: 'username',
82
+ judul: (r) => teks(r.nama),
83
+ meta: (r) => gabung(r.username, r.email),
84
+ avatar: true,
85
+ ikon: <UserRound />,
86
+ placeholder: 'Cari nama, username, atau email',
87
+ },
88
+ /** Orang (identitas tunggal, induk_orang.id). */
89
+ orang: {
90
+ nama: 'orang',
91
+ path: '/v1/induk/orang',
92
+ kunci: 'id',
93
+ satu: '/v1/induk/orang/{id}',
94
+ judul: (r) => teks(r.nama),
95
+ meta: (r) => gabung(r.username, r.email),
96
+ avatar: true,
97
+ ikon: <UserRound />,
98
+ placeholder: 'Cari nama, NIK, username, atau email',
99
+ },
100
+ /** Orang dicocokkan dengan NIK. */
101
+ nik: {
102
+ nama: 'orang',
103
+ path: '/v1/induk/orang',
104
+ kunci: 'nik',
105
+ saringKunci: 'nik',
106
+ judul: (r) => teks(r.nama),
107
+ meta: (r) => gabung(r.nik && `NIK ${r.nik}`, r.username),
108
+ avatar: true,
109
+ ikon: <UserRound />,
110
+ placeholder: 'Cari nama atau NIK',
111
+ },
112
+ ormawa: {
113
+ nama: 'organisasi mahasiswa',
114
+ path: '/v1/kemahasiswaan/ormawa',
115
+ kunci: 'id',
116
+ satu: '/v1/kemahasiswaan/ormawa/{id}',
117
+ judul: (r) => teks(r.nama),
118
+ meta: (r) => gabung(r.kode, r.jenis, r.bidang),
119
+ ikon: <UsersRound />,
120
+ placeholder: 'Cari nama atau kode ormawa',
121
+ },
122
+ 'mata-kuliah': {
123
+ nama: 'mata kuliah',
124
+ path: '/v1/mata-kuliah',
125
+ kunci: 'kode_mk',
126
+ judul: (r) => teks(r.nama_mk),
127
+ meta: (r) => gabung(r.kode_mk, r.sks_mk != null && `${r.sks_mk} SKS`, r.semester && `Semester ${r.semester}`),
128
+ ikon: <BookOpen />,
129
+ placeholder: 'Cari kode atau nama mata kuliah',
130
+ },
131
+ prodi: {
132
+ nama: 'program studi',
133
+ path: '/v1/referensi/prodi',
134
+ kunci: 'kode_prodi',
135
+ klien: true,
136
+ judul: (r) => gabung(r.kode_jenjang, r.nama_prodi).replace(' · ', ' '),
137
+ meta: (r) => gabung(r.kode_prodi, r.nama_fakultas),
138
+ ikon: <GraduationCap />,
139
+ placeholder: 'Cari program studi',
140
+ },
141
+ fakultas: {
142
+ nama: 'fakultas',
143
+ path: '/v1/referensi/fakultas',
144
+ kunci: 'kode_fakultas',
145
+ klien: true,
146
+ judul: (r) => teks(r.nama_fakultas || r.nama),
147
+ meta: (r) => teks(r.kode_fakultas),
148
+ ikon: <Landmark />,
149
+ placeholder: 'Cari fakultas',
150
+ },
151
+ unit: {
152
+ nama: 'unit',
153
+ path: '/v1/induk/unit',
154
+ kunci: 'id',
155
+ satu: '/v1/induk/unit/{id}',
156
+ judul: (r) => teks(r.nama),
157
+ meta: (r) => gabung(r.singkatan || r.kode, r.jenis),
158
+ ikon: <Network />,
159
+ placeholder: 'Cari nama atau kode unit',
160
+ },
161
+ jabatan: {
162
+ nama: 'jabatan',
163
+ path: '/v1/induk/jabatan',
164
+ kunci: 'id',
165
+ satu: '/v1/induk/jabatan/{id}',
166
+ judul: (r) => teks(r.nama),
167
+ meta: (r) => gabung(r.kode, r.kelompok),
168
+ ikon: <Briefcase />,
169
+ placeholder: 'Cari jabatan',
170
+ },
171
+ } satisfies Record<string, SumberEntitas>;
172
+
173
+ export type JenisEntitas = keyof typeof SUMBER_ENTITAS;
174
+
175
+ /**
176
+ * Tebak jenis entitas dari nama kolom dan keterangannya, untuk formulir yang dibangun otomatis dari skema API.
177
+ * Contoh: `pengaju_nim` + "m_mahasiswa.NIM" → mahasiswa, `konselor` + "user.username" → pengguna,
178
+ * `ormawa_id` + "ID di kmhs_ormawa" → ormawa. Mengembalikan null bila bukan rujukan ke data lain
179
+ * (kolom isian biasa seperti NIK pada formulir data pribadi tetap diketik).
180
+ */
181
+ export function jenisEntitasDariKolom(nama: string, keterangan = ''): JenisEntitas | null {
182
+ const n = nama.toLowerCase();
183
+ const k = keterangan.toLowerCase();
184
+ if (/m_mahasiswa\.nim|\bnim\b/.test(k) || /(^|_)nim$/.test(n)) return 'mahasiswa';
185
+ if (/m_dosen|\bnidn\b/.test(k) || /(^|_)nidn$/.test(n)) return 'dosen';
186
+ if (/user\.username|\busername\b/.test(k) || /(^|_)username$/.test(n)) return 'pengguna';
187
+ if (/kmhs_ormawa|kemahasiswaan_ormawa/.test(k) || n === 'ormawa_id') return 'ormawa';
188
+ if (/sdm_pegawai/.test(k) || n === 'pegawai_id' || n === 'sdm_pegawai_id') return 'pegawai';
189
+ if (/induk_orang\.nik/.test(k)) return 'nik';
190
+ if (/induk_orang/.test(k) || n === 'orang_id') return 'orang';
191
+ if (/induk_unit|sdm_unit/.test(k) || n === 'unit_id') return 'unit';
192
+ if (/induk_jabatan/.test(k) || n === 'jabatan_id') return 'jabatan';
193
+ if (/m_mata_kuliah|kode_mk/.test(k) || n === 'kode_mk') return 'mata-kuliah';
194
+ if (/(^|_)kode_prodi$/.test(n) || /m_prodi|kode_prodi/.test(k)) return 'prodi';
195
+ if (/(^|_)kode_fakultas$/.test(n) || /m_fakultas|kode_fakultas/.test(k)) return 'fakultas';
196
+ return null;
197
+ }
198
+
199
+ export interface PilihEntitasProps {
200
+ /** Jenis bawaan (`mahasiswa`, `dosen`, `pegawai`, `pengguna`, `orang`, `nik`, `ormawa`, `mata-kuliah`, `prodi`, `fakultas`, `unit`, `jabatan`) atau sumber sendiri. */
201
+ jenis: JenisEntitas | SumberEntitas;
202
+ /** Nilai = isi kolom kunci (ID, NIM, NIDN, username). */
203
+ value?: string | number | null;
204
+ defaultValue?: string | number | null;
205
+ /** Dipanggil dengan nilai kunci (string) dan baris lengkapnya; null saat dikosongkan. */
206
+ onValueChange?: (value: string | null, item: Baris | null) => void;
207
+ /** Saringan tambahan ke endpoint daftar, mis. `{ prodi: '55201' }`. */
208
+ query?: Record<string, string | number | boolean | undefined>;
209
+ /** Ganti pemuat (data contoh/uji). */
210
+ load?: (q: string, signal: AbortSignal) => Promise<Baris[]>;
211
+ limit?: number;
212
+ placeholder?: string;
213
+ name?: string;
214
+ id?: string;
215
+ disabled?: boolean;
216
+ size?: ControlSize;
217
+ className?: string;
218
+ 'aria-label'?: string;
219
+ }
220
+
221
+ /**
222
+ * Isian cari-dan-pilih untuk merujuk data lain, pengganti isian ID/NIM/NIDN/username yang diketik manual.
223
+ * Nilainya tetap kunci (mis. NIM), jadi bisa langsung dipakai di formulir dan dikirim ke API. Nilai awal
224
+ * ditampilkan sebagai nama, bukan angka.
225
+ *
226
+ * ```tsx
227
+ * <PilihEntitas jenis="mahasiswa" value={nim} onValueChange={setNim} />
228
+ * <PilihEntitas jenis="ormawa" name="ormawa_id" defaultValue={baris.ormawa_id} />
229
+ * <PilihEntitas jenis={jenisEntitasDariKolom(kolom.nama, kolom.keterangan) ?? 'pengguna'} ... />
230
+ * ```
231
+ */
232
+ export function PilihEntitas({ jenis, value, defaultValue, onValueChange, query, load, limit = 20, placeholder, name, id, disabled, size, className, ...rest }: PilihEntitasProps) {
233
+ const siakad = useOptionalSiakad();
234
+ const src: SumberEntitas = typeof jenis === 'string' ? SUMBER_ENTITAS[jenis] : jenis;
235
+ const kunciDari = React.useCallback((r: Baris) => teks(r[src.kunci]), [src.kunci]);
236
+ const [inner, setInner] = React.useState<string | null>(defaultValue == null || defaultValue === '' ? null : String(defaultValue));
237
+ const nilai = value !== undefined ? (value == null || value === '' ? null : String(value)) : inner;
238
+ const [item, setItem] = React.useState<Baris | null>(null);
239
+ const q = JSON.stringify(query ?? {});
240
+
241
+ // Cache daftar kecil (mode klien) per komponen.
242
+ const semua = React.useRef<Promise<Baris[]> | null>(null);
243
+ React.useEffect(() => {
244
+ semua.current = null;
245
+ }, [src.path, q]);
246
+
247
+ const ambilDaftar = React.useCallback(
248
+ async (kata: string, signal: AbortSignal, ekstra: Record<string, unknown> = {}): Promise<Baris[]> => {
249
+ if (load) return load(kata, signal);
250
+ if (!siakad) throw new Error('SDK belum dipasang di <UnipoProvider>.');
251
+ if (src.klien) {
252
+ semua.current ??= siakad.request<Baris[]>({ method: 'GET', path: src.path, query: { ...src.query, ...JSON.parse(q) } }).then((r) => (Array.isArray(r.data) ? r.data : []));
253
+ const rows = await semua.current;
254
+ const t = kata.trim().toLowerCase();
255
+ return t ? rows.filter((r) => `${src.judul(r)} ${src.meta?.(r) ?? ''} ${kunciDari(r)}`.toLowerCase().includes(t)) : rows;
256
+ }
257
+ const r = await siakad.request<Baris[]>({ method: 'GET', path: src.path, query: { ...src.query, ...JSON.parse(q), q: kata || undefined, per_page: limit, ...ekstra } }, { signal });
258
+ return Array.isArray(r.data) ? r.data : [];
259
+ },
260
+ // eslint-disable-next-line react-hooks/exhaustive-deps
261
+ [siakad, load, src.path, src.klien, q, limit],
262
+ );
263
+
264
+ // Nilai dari luar (mis. formulir ubah) → muat barisnya agar tampil sebagai nama.
265
+ React.useEffect(() => {
266
+ if (!nilai) return setItem(null);
267
+ if (item && kunciDari(item) === nilai) return;
268
+ const stub: Baris = { [src.kunci]: nilai, __stub: true };
269
+ setItem(stub);
270
+ const ctrl = new AbortController();
271
+ (async () => {
272
+ if (src.satu && siakad && !load) {
273
+ const r = await siakad.request<Baris>({ method: 'GET', path: src.satu, query: { id: nilai } }, { signal: ctrl.signal });
274
+ return r.data;
275
+ }
276
+ const rows = await ambilDaftar(src.saringKunci ? '' : nilai, ctrl.signal, src.saringKunci ? { [src.saringKunci]: nilai } : {});
277
+ return rows.find((r) => kunciDari(r) === nilai) ?? null;
278
+ })()
279
+ .then((r) => !ctrl.signal.aborted && r && kunciDari(r) === nilai && setItem(r))
280
+ .catch(() => undefined);
281
+ return () => ctrl.abort();
282
+ // eslint-disable-next-line react-hooks/exhaustive-deps
283
+ }, [nilai, src.path, src.kunci]);
284
+
285
+ const label = (r: Baris) => (r.__stub ? teks(r[src.kunci]) : src.judul(r) || kunciDari(r));
286
+ return (
287
+ <Combobox<Baris>
288
+ {...rest}
289
+ id={id}
290
+ name={name}
291
+ size={size}
292
+ disabled={disabled}
293
+ className={className}
294
+ placeholder={placeholder ?? src.placeholder ?? `Cari ${src.nama}`}
295
+ icon={src.ikon}
296
+ loadItems={ambilDaftar}
297
+ value={item}
298
+ onValueChange={(r) => {
299
+ const k = r ? kunciDari(r) : null;
300
+ setItem(r);
301
+ setInner(k);
302
+ onValueChange?.(k, r);
303
+ }}
304
+ itemToString={label}
305
+ itemKey={kunciDari}
306
+ emptyText={`Tidak ada ${src.nama} yang cocok.`}
307
+ renderItem={(r) => (
308
+ <>
309
+ {src.avatar ? (
310
+ <Avatar name={label(r)} src={typeof r.foto === 'string' ? r.foto : undefined} size="sm" />
311
+ ) : (
312
+ <span className="u-option-media" data-shape="square">
313
+ {src.ikon ?? <Building2 size={14} />}
314
+ </span>
315
+ )}
316
+ <OptionContent title={label(r)} meta={src.meta?.(r)} />
317
+ </>
318
+ )}
319
+ />
320
+ );
321
+ }
@@ -2,6 +2,7 @@
2
2
  import * as React from 'react';
3
3
  import type { ApiResult, Meta, Siakad } from 'unipo-siakad-sdk';
4
4
  import { Toaster, TooltipProvider } from '../components/overlays';
5
+ import { requestIdDari } from '../components/galat';
5
6
 
6
7
  const SiakadContext = React.createContext<Siakad | null>(null);
7
8
 
@@ -145,14 +146,22 @@ export function useSiakadQuery<T>(key: ReadonlyArray<unknown>, fn: (siakad: Siak
145
146
  };
146
147
  }
147
148
 
148
- /** Pesan galat ramah dari galat SDK (SiakadError punya .status dan .message). */
149
- export function pesanGalat(e: unknown): string {
149
+ /**
150
+ * Pesan galat ramah dari galat SDK (SiakadError punya .status dan .message). Untuk galat server (5xx) pesan
151
+ * menyertakan kode laporan (request_id); matikan dengan `{ kode: false }` bila kode ditampilkan terpisah
152
+ * dengan <KodeLaporan />.
153
+ */
154
+ export function pesanGalat(e: unknown, opsi: { kode?: boolean } = {}): string {
150
155
  const err = e as { status?: number; message?: string } | null;
151
156
  if (!err) return 'Terjadi kesalahan.';
152
157
  if (err.status === 401) return 'Sesi Anda berakhir. Silakan masuk lagi.';
153
158
  if (err.status === 403) return 'Akun Anda belum punya izin untuk data ini.';
154
159
  if (err.status === 404) return 'Data tidak ditemukan.';
155
160
  if (err.status === 429) return 'Terlalu banyak permintaan. Coba lagi sebentar lagi.';
156
- if (err.status && err.status >= 500) return 'Server SIAKAD sedang bermasalah. Coba lagi beberapa saat.';
161
+ if (err.status && err.status >= 500) {
162
+ // Sertakan kode laporan agar teks ini juga berguna di toast (tempat <KodeLaporan /> tidak bisa dipasang).
163
+ const id = opsi.kode === false ? null : requestIdDari(e);
164
+ return `Server SIAKAD sedang bermasalah. Coba lagi beberapa saat.${id ? ` Kode laporan: ${id}.` : ''}`;
165
+ }
157
166
  return err.message || 'Terjadi kesalahan.';
158
167
  }