unipo-ui 1.4.0 → 1.5.0

package/dist/{EditorBlok-CarZErBW.d.cts → LembarSurat-CShVDBwp.d.cts}

@@ -42,7 +42,11 @@ declare const hitungKata: (daftar: Blok[]) => number;
 declare function cariBlok(daftar: Blok[], id: string): Blok | null;
 /** Ganti satu blok (di tingkat mana pun) lewat fungsi. */
 declare function ubahBlok(daftar: Blok[], id: string, f: (b: Blok) => Blok): Blok[];
-/** Ubah isi HTML konten lama (sebelum ada editor blok) menjadi blok supaya bisa disunting. */
+/**
+ * HTML ke blok. Mengenali kembali HTML `ub-*` hasil blokKeHtml (perataan, paragraf pembuka, kolom, tabel, sorotan,
+ * spasi, tombol, galeri, berkas, akordion), jadi isi surat/templat yang disimpan server bisa disunting ulang tanpa
+ * kehilangan tata letak. HTML lain (impor lama) diubah sebaik mungkin.
+ */
 declare function htmlKeBlok(html?: string | null): Blok[];
 /** Semua blok (termasuk anak kolom) yang memenuhi syarat. */
 declare function cariSemua(daftar: Blok[], syarat: (b: Blok) => boolean): Blok[];
@@ -86,6 +90,8 @@ interface KonteksEditor {
     pilihMedia: (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
     pola: PolaBlok[] | undefined;
     baca: boolean;
+    /** Tipe blok yang boleh disisipkan (bawaan semua). */
+    tipe?: TipeBlok[];
 }
 declare const useEditor: () => KonteksEditor;
 
@@ -143,6 +149,8 @@ interface EditorBlokProps {
     kepala?: React.ReactNode;
     /** Mode baca: tanpa bilah, tidak bisa diketik. */
     baca?: boolean;
+    /** Batasi tipe blok yang bisa disisipkan, mis. untuk surat. */
+    tipe?: TipeBlok[];
     className?: string;
 }
 /**
@@ -150,6 +158,62 @@ interface EditorBlokProps {
  * seret untuk memindah, bilah format (tebal, miring, tautan, sorot, kode), dan Ctrl+Z / Ctrl+Shift+Z.
  * Format blok sama dengan Blok.php di SIAKAD.
  */
-declare function EditorBlok({ blok, set, urung, ulang, pilih: pilihProp, setPilih: setPilihProp, pilihMedia: pilihMediaProp, unggah, sumberMedia, pola, kepala, baca, className }: EditorBlokProps): React.JSX.Element;
+declare function EditorBlok({ blok, set, urung, ulang, pilih: pilihProp, setPilih: setPilihProp, pilihMedia: pilihMediaProp, unggah, sumberMedia, pola, kepala, baca, tipe, className }: EditorBlokProps): React.JSX.Element;
+
+type UkuranKertas = 'a4' | 'f4' | 'letter';
+/** Kop surat: logo, nama instansi, unit, dan alamat. */
+interface KopSurat {
+    logo?: string;
+    instansi: string;
+    /** Unit pengirim, mis. "Fakultas Teknik". */
+    unit?: string;
+    alamat?: string;
+    /** Telepon, surel, situs dalam satu baris. */
+    kontak?: string;
+}
+interface TujuanSurat {
+    nama: string;
+    jabatan?: string | null;
+    instansi?: string | null;
+    alamat?: string | null;
+    tembusan?: boolean;
+}
+interface PenandatanganSurat {
+    jabatan: string;
+    nama: string;
+    /** NIP/NIDN/NIK, ditulis apa adanya, mis. "NIDN 0912078501". */
+    nomorInduk?: string;
+    /** Gambar tanda tangan atau QR tanda tangan elektronik. */
+    ttd?: string;
+    /** Tautan cek keaslian (GET /v1/arsip/verifikasi/{kode}); tampil di bawah tanda tangan. */
+    verifikasi?: string;
+}
+interface LembarSuratProps {
+    kop?: KopSurat | React.ReactNode;
+    nomor?: string | null;
+    lampiran?: string | null;
+    perihal?: string | null;
+    sifat?: string | null;
+    /** Tanggal surat (YYYY-MM-DD) atau teks jadi. */
+    tanggal?: string | Date | null;
+    /** Tempat di depan tanggal, mis. "Marisa". */
+    tempat?: string;
+    tujuan?: TujuanSurat[] | React.ReactNode;
+    /** Isi surat (HTML). Disaring seperti server sebelum ditampilkan. */
+    isi: string;
+    penandatangan?: PenandatanganSurat;
+    /** Daftar tembusan; tanpa ini diambil dari `tujuan` yang bertanda tembusan. */
+    tembusan?: string[];
+    kertas?: UkuranKertas;
+    /** Tampilkan bayangan kertas di layar (bawaan true). Saat dicetak selalu polos. */
+    bayangan?: boolean;
+    className?: string;
+}
+/**
+ * Satu lembar surat dinas siap cetak: kop, nomor/lampiran/perihal, tanggal, tujuan, isi, tanda tangan, dan
+ * tembusan. Ukuran kertas A4/F4/Letter dengan margin surat dinas; `window.print()` mencetak lembarnya saja bila
+ * dibungkus `.u-cetak-saja` (lihat dokumentasi).
+ */
+declare function LembarSurat({ kop, nomor, lampiran, perihal, sifat, tanggal, tempat, tujuan, isi, penandatangan, tembusan, kertas, bayangan, className }: LembarSuratProps): React.JSX.Element;
 
-export { type Blok as B, DEF as D, EditorBlok as E, type Grup as G, type MediaEditor as M, type OpsiPilihMedia as O, type PolaBlok as P, RASIO as R, type SumberMedia as S, type TipeBlok as T, URUTAN_GRUP as U, type PilihMedia as a, type DefBlok as b, type EditorBlokProps as c, type MintaFokus as d, baru as e, cariBlok as f, cariSemua as g, hitungKata as h, htmlKeBlok as i, idBaru as j, useEditor as k, usePemilihMediaBawaan as l, useRiwayatBlok as m, rapikan as r, salinBaru as s, teksBlok as t, ubahBlok as u };
+export { type Blok as B, DEF as D, EditorBlok as E, type Grup as G, type KopSurat as K, LembarSurat as L, type MediaEditor as M, type OpsiPilihMedia as O, type PolaBlok as P, RASIO as R, type SumberMedia as S, type TipeBlok as T, type UkuranKertas as U, type PilihMedia as a, type PenandatanganSurat as b, type DefBlok as c, type EditorBlokProps as d, type LembarSuratProps as e, type MintaFokus as f, type TujuanSurat as g, URUTAN_GRUP as h, baru as i, cariBlok as j, cariSemua as k, hitungKata as l, htmlKeBlok as m, idBaru as n, useEditor as o, usePemilihMediaBawaan as p, useRiwayatBlok as q, rapikan as r, salinBaru as s, teksBlok as t, ubahBlok as u };

package/dist/{EditorBlok-CarZErBW.d.ts → LembarSurat-CShVDBwp.d.ts}

@@ -42,7 +42,11 @@ declare const hitungKata: (daftar: Blok[]) => number;
 declare function cariBlok(daftar: Blok[], id: string): Blok | null;
 /** Ganti satu blok (di tingkat mana pun) lewat fungsi. */
 declare function ubahBlok(daftar: Blok[], id: string, f: (b: Blok) => Blok): Blok[];
-/** Ubah isi HTML konten lama (sebelum ada editor blok) menjadi blok supaya bisa disunting. */
+/**
+ * HTML ke blok. Mengenali kembali HTML `ub-*` hasil blokKeHtml (perataan, paragraf pembuka, kolom, tabel, sorotan,
+ * spasi, tombol, galeri, berkas, akordion), jadi isi surat/templat yang disimpan server bisa disunting ulang tanpa
+ * kehilangan tata letak. HTML lain (impor lama) diubah sebaik mungkin.
+ */
 declare function htmlKeBlok(html?: string | null): Blok[];
 /** Semua blok (termasuk anak kolom) yang memenuhi syarat. */
 declare function cariSemua(daftar: Blok[], syarat: (b: Blok) => boolean): Blok[];
@@ -86,6 +90,8 @@ interface KonteksEditor {
     pilihMedia: (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
     pola: PolaBlok[] | undefined;
     baca: boolean;
+    /** Tipe blok yang boleh disisipkan (bawaan semua). */
+    tipe?: TipeBlok[];
 }
 declare const useEditor: () => KonteksEditor;
 
@@ -143,6 +149,8 @@ interface EditorBlokProps {
     kepala?: React.ReactNode;
     /** Mode baca: tanpa bilah, tidak bisa diketik. */
     baca?: boolean;
+    /** Batasi tipe blok yang bisa disisipkan, mis. untuk surat. */
+    tipe?: TipeBlok[];
     className?: string;
 }
 /**
@@ -150,6 +158,62 @@ interface EditorBlokProps {
  * seret untuk memindah, bilah format (tebal, miring, tautan, sorot, kode), dan Ctrl+Z / Ctrl+Shift+Z.
  * Format blok sama dengan Blok.php di SIAKAD.
  */
-declare function EditorBlok({ blok, set, urung, ulang, pilih: pilihProp, setPilih: setPilihProp, pilihMedia: pilihMediaProp, unggah, sumberMedia, pola, kepala, baca, className }: EditorBlokProps): React.JSX.Element;
+declare function EditorBlok({ blok, set, urung, ulang, pilih: pilihProp, setPilih: setPilihProp, pilihMedia: pilihMediaProp, unggah, sumberMedia, pola, kepala, baca, tipe, className }: EditorBlokProps): React.JSX.Element;
+
+type UkuranKertas = 'a4' | 'f4' | 'letter';
+/** Kop surat: logo, nama instansi, unit, dan alamat. */
+interface KopSurat {
+    logo?: string;
+    instansi: string;
+    /** Unit pengirim, mis. "Fakultas Teknik". */
+    unit?: string;
+    alamat?: string;
+    /** Telepon, surel, situs dalam satu baris. */
+    kontak?: string;
+}
+interface TujuanSurat {
+    nama: string;
+    jabatan?: string | null;
+    instansi?: string | null;
+    alamat?: string | null;
+    tembusan?: boolean;
+}
+interface PenandatanganSurat {
+    jabatan: string;
+    nama: string;
+    /** NIP/NIDN/NIK, ditulis apa adanya, mis. "NIDN 0912078501". */
+    nomorInduk?: string;
+    /** Gambar tanda tangan atau QR tanda tangan elektronik. */
+    ttd?: string;
+    /** Tautan cek keaslian (GET /v1/arsip/verifikasi/{kode}); tampil di bawah tanda tangan. */
+    verifikasi?: string;
+}
+interface LembarSuratProps {
+    kop?: KopSurat | React.ReactNode;
+    nomor?: string | null;
+    lampiran?: string | null;
+    perihal?: string | null;
+    sifat?: string | null;
+    /** Tanggal surat (YYYY-MM-DD) atau teks jadi. */
+    tanggal?: string | Date | null;
+    /** Tempat di depan tanggal, mis. "Marisa". */
+    tempat?: string;
+    tujuan?: TujuanSurat[] | React.ReactNode;
+    /** Isi surat (HTML). Disaring seperti server sebelum ditampilkan. */
+    isi: string;
+    penandatangan?: PenandatanganSurat;
+    /** Daftar tembusan; tanpa ini diambil dari `tujuan` yang bertanda tembusan. */
+    tembusan?: string[];
+    kertas?: UkuranKertas;
+    /** Tampilkan bayangan kertas di layar (bawaan true). Saat dicetak selalu polos. */
+    bayangan?: boolean;
+    className?: string;
+}
+/**
+ * Satu lembar surat dinas siap cetak: kop, nomor/lampiran/perihal, tanggal, tujuan, isi, tanda tangan, dan
+ * tembusan. Ukuran kertas A4/F4/Letter dengan margin surat dinas; `window.print()` mencetak lembarnya saja bila
+ * dibungkus `.u-cetak-saja` (lihat dokumentasi).
+ */
+declare function LembarSurat({ kop, nomor, lampiran, perihal, sifat, tanggal, tempat, tujuan, isi, penandatangan, tembusan, kertas, bayangan, className }: LembarSuratProps): React.JSX.Element;
 
-export { type Blok as B, DEF as D, EditorBlok as E, type Grup as G, type MediaEditor as M, type OpsiPilihMedia as O, type PolaBlok as P, RASIO as R, type SumberMedia as S, type TipeBlok as T, URUTAN_GRUP as U, type PilihMedia as a, type DefBlok as b, type EditorBlokProps as c, type MintaFokus as d, baru as e, cariBlok as f, cariSemua as g, hitungKata as h, htmlKeBlok as i, idBaru as j, useEditor as k, usePemilihMediaBawaan as l, useRiwayatBlok as m, rapikan as r, salinBaru as s, teksBlok as t, ubahBlok as u };
+export { type Blok as B, DEF as D, EditorBlok as E, type Grup as G, type KopSurat as K, LembarSurat as L, type MediaEditor as M, type OpsiPilihMedia as O, type PolaBlok as P, RASIO as R, type SumberMedia as S, type TipeBlok as T, type UkuranKertas as U, type PilihMedia as a, type PenandatanganSurat as b, type DefBlok as c, type EditorBlokProps as d, type LembarSuratProps as e, type MintaFokus as f, type TujuanSurat as g, URUTAN_GRUP as h, baru as i, cariBlok as j, cariSemua as k, hitungKata as l, htmlKeBlok as m, idBaru as n, useEditor as o, usePemilihMediaBawaan as p, useRiwayatBlok as q, rapikan as r, salinBaru as s, teksBlok as t, ubahBlok as u };