unipo-ui 1.3.0 → 1.5.0

package/dist/LembarSurat-CShVDBwp.d.cts

@@ -0,0 +1,219 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+
+/**
+ * Format blok sama dengan backend (app/Modules/Humas/Support/Blok.php di SIAKAD), jadi isi editor ini bisa
+ * langsung dikirim ke /v1/humas/... sebagai `blok`:
+ * {"id": "b1", "tipe": "paragraf", "data": {...}, "anak": [[...], [...]]}. `anak` hanya untuk blok kolom.
+ */
+type TipeBlok = 'paragraf' | 'judul' | 'daftar' | 'kutipan' | 'gambar' | 'galeri' | 'video' | 'tombol' | 'pemisah' | 'spasi' | 'kolom' | 'tabel' | 'kode' | 'sorotan' | 'berkas' | 'akordion' | 'peta';
+interface Blok {
+    id: string;
+    tipe: TipeBlok;
+    data: Record<string, any>;
+    anak?: Blok[][];
+}
+type Grup = 'Teks' | 'Media' | 'Tata letak' | 'Sematan';
+interface DefBlok {
+    label: string;
+    ikon: LucideIcon;
+    grup: Grup;
+    deskripsi: string;
+    /** Kata kunci pencarian di penyisip (selain label). */
+    kunci?: string;
+    data: () => Record<string, unknown>;
+    anak?: () => Blok[][];
+    /** Punya teks utama yang bisa diketik langsung (Enter memecah, Backspace menggabung). */
+    teks?: boolean;
+}
+declare const RASIO: Record<string, number>;
+declare const DEF: Record<TipeBlok, DefBlok>;
+declare const URUTAN_GRUP: Grup[];
+declare const idBaru: () => string;
+declare function baru(tipe: TipeBlok, data?: Record<string, unknown>): Blok;
+/** Salin blok dengan id baru (duplikat, sisip pola). */
+declare function salinBaru(b: Blok): Blok;
+/** Pola dari server tidak menyimpan id; beri id dan lengkapi data bawaan. */
+declare function rapikan(daftar: unknown): Blok[];
+/** Teks polos semua blok (hitung kata, ringkasan otomatis). */
+declare function teksBlok(daftar: Blok[]): string;
+declare const hitungKata: (daftar: Blok[]) => number;
+/** Cari blok di semua tingkat (termasuk anak kolom). */
+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[];
+/**
+ * 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[];
+
+interface MintaFokus {
+    id: string;
+    /** 'awal', 'akhir', atau posisi karakter di teks polos. */
+    di: 'awal' | 'akhir' | number;
+}
+/** Berkas media yang dipilih untuk blok gambar, galeri, atau berkas. */
+interface MediaEditor {
+    url: string;
+    id?: number | string;
+    alt?: string;
+    judul?: string;
+    nama?: string;
+    /** Ukuran dalam byte (blok berkas). */
+    ukuran?: number | null;
+    mime?: string | null;
+    /** Gambar kecil untuk kisi pustaka (bawaan `url`). */
+    pratinjau?: string | null;
+}
+interface OpsiPilihMedia {
+    jenis?: 'gambar' | 'dokumen';
+    banyak?: boolean;
+}
+/** Pola: susunan blok siap pakai (mis. "Berita kegiatan", "Pengumuman beasiswa"). */
+interface PolaBlok {
+    id: string | number;
+    nama: string;
+    kategori: string;
+    deskripsi?: string;
+    blok: unknown;
+}
+interface KonteksEditor {
+    pilih: string | null;
+    setPilih: (id: string | null) => void;
+    fokus: MintaFokus | null;
+    setFokus: (f: MintaFokus | null) => void;
+    /** Buka pemilih media; hasil null bila dibatalkan. */
+    pilihMedia: (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
+    pola: PolaBlok[] | undefined;
+    baca: boolean;
+    /** Tipe blok yang boleh disisipkan (bawaan semua). */
+    tipe?: TipeBlok[];
+}
+declare const useEditor: () => KonteksEditor;
+
+/** Isi blok dengan riwayat urung/ulang. Ketikan beruntun (< 1 detik) digabung jadi satu langkah. */
+declare function useRiwayatBlok(awal: Blok[]): {
+    blok: Blok[];
+    set: (kini: Blok[]) => void;
+    urung: () => void;
+    ulang: () => void;
+    reset: (b: Blok[]) => void;
+    bisaUrung: boolean;
+    bisaUlang: boolean;
+};
+type PilihMedia = (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
+/**
+ * Sumber "pilih dari sistem" untuk pemilih bawaan: berkas yang sudah ada di server, dicari dengan kata kunci.
+ * Contoh siap pakai: `useMediaPortal(situs)` di `unipo-ui/siakad` (pustaka media /v1/portal/kelola/media).
+ */
+interface SumberMedia {
+    /** Label tab, bawaan "Pustaka". */
+    nama?: string;
+    cari: (q: string, opsi: OpsiPilihMedia & {
+        halaman: number;
+    }, signal: AbortSignal) => Promise<{
+        data: MediaEditor[];
+        adaLagi?: boolean;
+    }>;
+}
+/**
+ * Pemilih media bawaan dengan tiga cara: pilih dari sistem (`sumber`, dengan pencarian), unggah dari perangkat
+ * (`unggah`, mis. ke pustaka media portal), dan tempel alamat. Kembalikan `{ pilihMedia, dialog }`; taruh `dialog`
+ * di dalam pohon React.
+ */
+declare function usePemilihMediaBawaan(unggah?: (file: File, opsi: OpsiPilihMedia) => Promise<MediaEditor>, sumber?: SumberMedia): {
+    pilihMedia: PilihMedia;
+    dialog: React.JSX.Element;
+};
+interface EditorBlokProps {
+    blok: Blok[];
+    set: (b: Blok[]) => void;
+    urung?: () => void;
+    ulang?: () => void;
+    /** Blok terpilih (dikendalikan, agar panel samping bisa memakai yang sama). */
+    pilih?: string | null;
+    setPilih?: (id: string | null) => void;
+    /** Pemilih media sendiri (pustaka media). Tanpa ini dipakai dialog URL/unggah bawaan. */
+    pilihMedia?: PilihMedia;
+    /** Unggah berkas untuk pemilih bawaan. */
+    unggah?: (file: File, opsi: OpsiPilihMedia) => Promise<MediaEditor>;
+    /** Berkas yang sudah ada di sistem untuk tab Pustaka di pemilih bawaan (cari + pilih). */
+    sumberMedia?: SumberMedia;
+    /** Pola blok siap pakai di penyisip (tab Pola). */
+    pola?: PolaBlok[];
+    /** Isi di atas kanvas, mis. isian judul. */
+    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;
+}
+/**
+ * Kanvas editor blok gaya Gutenberg: ketik langsung, `/` untuk memilih blok, pintasan Markdown (##, -, 1., >, ---),
+ * 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, 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 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/LembarSurat-CShVDBwp.d.ts

@@ -0,0 +1,219 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+
+/**
+ * Format blok sama dengan backend (app/Modules/Humas/Support/Blok.php di SIAKAD), jadi isi editor ini bisa
+ * langsung dikirim ke /v1/humas/... sebagai `blok`:
+ * {"id": "b1", "tipe": "paragraf", "data": {...}, "anak": [[...], [...]]}. `anak` hanya untuk blok kolom.
+ */
+type TipeBlok = 'paragraf' | 'judul' | 'daftar' | 'kutipan' | 'gambar' | 'galeri' | 'video' | 'tombol' | 'pemisah' | 'spasi' | 'kolom' | 'tabel' | 'kode' | 'sorotan' | 'berkas' | 'akordion' | 'peta';
+interface Blok {
+    id: string;
+    tipe: TipeBlok;
+    data: Record<string, any>;
+    anak?: Blok[][];
+}
+type Grup = 'Teks' | 'Media' | 'Tata letak' | 'Sematan';
+interface DefBlok {
+    label: string;
+    ikon: LucideIcon;
+    grup: Grup;
+    deskripsi: string;
+    /** Kata kunci pencarian di penyisip (selain label). */
+    kunci?: string;
+    data: () => Record<string, unknown>;
+    anak?: () => Blok[][];
+    /** Punya teks utama yang bisa diketik langsung (Enter memecah, Backspace menggabung). */
+    teks?: boolean;
+}
+declare const RASIO: Record<string, number>;
+declare const DEF: Record<TipeBlok, DefBlok>;
+declare const URUTAN_GRUP: Grup[];
+declare const idBaru: () => string;
+declare function baru(tipe: TipeBlok, data?: Record<string, unknown>): Blok;
+/** Salin blok dengan id baru (duplikat, sisip pola). */
+declare function salinBaru(b: Blok): Blok;
+/** Pola dari server tidak menyimpan id; beri id dan lengkapi data bawaan. */
+declare function rapikan(daftar: unknown): Blok[];
+/** Teks polos semua blok (hitung kata, ringkasan otomatis). */
+declare function teksBlok(daftar: Blok[]): string;
+declare const hitungKata: (daftar: Blok[]) => number;
+/** Cari blok di semua tingkat (termasuk anak kolom). */
+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[];
+/**
+ * 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[];
+
+interface MintaFokus {
+    id: string;
+    /** 'awal', 'akhir', atau posisi karakter di teks polos. */
+    di: 'awal' | 'akhir' | number;
+}
+/** Berkas media yang dipilih untuk blok gambar, galeri, atau berkas. */
+interface MediaEditor {
+    url: string;
+    id?: number | string;
+    alt?: string;
+    judul?: string;
+    nama?: string;
+    /** Ukuran dalam byte (blok berkas). */
+    ukuran?: number | null;
+    mime?: string | null;
+    /** Gambar kecil untuk kisi pustaka (bawaan `url`). */
+    pratinjau?: string | null;
+}
+interface OpsiPilihMedia {
+    jenis?: 'gambar' | 'dokumen';
+    banyak?: boolean;
+}
+/** Pola: susunan blok siap pakai (mis. "Berita kegiatan", "Pengumuman beasiswa"). */
+interface PolaBlok {
+    id: string | number;
+    nama: string;
+    kategori: string;
+    deskripsi?: string;
+    blok: unknown;
+}
+interface KonteksEditor {
+    pilih: string | null;
+    setPilih: (id: string | null) => void;
+    fokus: MintaFokus | null;
+    setFokus: (f: MintaFokus | null) => void;
+    /** Buka pemilih media; hasil null bila dibatalkan. */
+    pilihMedia: (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
+    pola: PolaBlok[] | undefined;
+    baca: boolean;
+    /** Tipe blok yang boleh disisipkan (bawaan semua). */
+    tipe?: TipeBlok[];
+}
+declare const useEditor: () => KonteksEditor;
+
+/** Isi blok dengan riwayat urung/ulang. Ketikan beruntun (< 1 detik) digabung jadi satu langkah. */
+declare function useRiwayatBlok(awal: Blok[]): {
+    blok: Blok[];
+    set: (kini: Blok[]) => void;
+    urung: () => void;
+    ulang: () => void;
+    reset: (b: Blok[]) => void;
+    bisaUrung: boolean;
+    bisaUlang: boolean;
+};
+type PilihMedia = (opsi?: OpsiPilihMedia) => Promise<MediaEditor[] | null>;
+/**
+ * Sumber "pilih dari sistem" untuk pemilih bawaan: berkas yang sudah ada di server, dicari dengan kata kunci.
+ * Contoh siap pakai: `useMediaPortal(situs)` di `unipo-ui/siakad` (pustaka media /v1/portal/kelola/media).
+ */
+interface SumberMedia {
+    /** Label tab, bawaan "Pustaka". */
+    nama?: string;
+    cari: (q: string, opsi: OpsiPilihMedia & {
+        halaman: number;
+    }, signal: AbortSignal) => Promise<{
+        data: MediaEditor[];
+        adaLagi?: boolean;
+    }>;
+}
+/**
+ * Pemilih media bawaan dengan tiga cara: pilih dari sistem (`sumber`, dengan pencarian), unggah dari perangkat
+ * (`unggah`, mis. ke pustaka media portal), dan tempel alamat. Kembalikan `{ pilihMedia, dialog }`; taruh `dialog`
+ * di dalam pohon React.
+ */
+declare function usePemilihMediaBawaan(unggah?: (file: File, opsi: OpsiPilihMedia) => Promise<MediaEditor>, sumber?: SumberMedia): {
+    pilihMedia: PilihMedia;
+    dialog: React.JSX.Element;
+};
+interface EditorBlokProps {
+    blok: Blok[];
+    set: (b: Blok[]) => void;
+    urung?: () => void;
+    ulang?: () => void;
+    /** Blok terpilih (dikendalikan, agar panel samping bisa memakai yang sama). */
+    pilih?: string | null;
+    setPilih?: (id: string | null) => void;
+    /** Pemilih media sendiri (pustaka media). Tanpa ini dipakai dialog URL/unggah bawaan. */
+    pilihMedia?: PilihMedia;
+    /** Unggah berkas untuk pemilih bawaan. */
+    unggah?: (file: File, opsi: OpsiPilihMedia) => Promise<MediaEditor>;
+    /** Berkas yang sudah ada di sistem untuk tab Pustaka di pemilih bawaan (cari + pilih). */
+    sumberMedia?: SumberMedia;
+    /** Pola blok siap pakai di penyisip (tab Pola). */
+    pola?: PolaBlok[];
+    /** Isi di atas kanvas, mis. isian judul. */
+    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;
+}
+/**
+ * Kanvas editor blok gaya Gutenberg: ketik langsung, `/` untuk memilih blok, pintasan Markdown (##, -, 1., >, ---),
+ * 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, 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 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 };