unipo-ui 1.3.0 → 1.4.0

package/dist/EditorBlok-CarZErBW.d.cts

@@ -0,0 +1,155 @@
+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[];
+/** Ubah isi HTML konten lama (sebelum ada editor blok) menjadi blok supaya bisa disunting. */
+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;
+}
+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;
+    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, className }: EditorBlokProps): 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 };

package/dist/EditorBlok-CarZErBW.d.ts

@@ -0,0 +1,155 @@
+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[];
+/** Ubah isi HTML konten lama (sebelum ada editor blok) menjadi blok supaya bisa disunting. */
+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;
+}
+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;
+    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, className }: EditorBlokProps): 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 };