@starasia/admin 12.41.0 → 12.42.0

package/dist/components/AppLayout/index.d.ts

@@ -47,13 +47,14 @@ interface AppLayoutProps {
     /**
      * Optional: array tombol di profile menu body. Caller bisa tambah
      * berapapun item terstruktur (Settings, Bahasa, Tema, dll). Tiap item
-     * dirender sebagai `<MenuButton>` dengan style konsisten.
+     * dirender sebagai `<MenuItem>` dari `@starasia/menu` — hover, spacing,
+     * dan auto-close saat dipilih mengikuti komponen menu DS.
      */
     profileMenuButtons?: ProfileMenuButton[];
     /**
      * Optional: slot kustom tambahan di profile menu body (setelah
      * `profileMenuButtons`). Pakai untuk konten non-button atau item dengan
-     * style/struktur custom. Caller compose `<MenuButton>` sendiri.
+     * style/struktur custom. Caller compose `<MenuItem>` sendiri.
      */
     profileMenuItems?: ReactNode;
     /**

package/dist/components/RightDrawer/index.d.ts

@@ -12,16 +12,82 @@ export interface RightDrawerProps {
     style?: CSSProperties;
     children: ReactNode;
     closeButton?: CloseButton | null | false;
+    /**
+     * Padding kiri/kanan body panel. Default `true` (`lg`, sama seperti
+     * sebelumnya). Set `false` kalau konten mau edge-to-edge horizontal — mis.
+     * list/tabel yang punya padding row sendiri. Padding atas/bawah dan header
+     * bar tidak terpengaruh.
+     */
     paddingHorizontal?: boolean;
     width?: CSSProperties["width"];
     minWidth?: CSSProperties["minWidth"];
     maxWidth?: CSSProperties["maxWidth"];
+    hideBackdrop?: boolean;
+    /**
+     * Konten sisi kiri header bar — judul, breadcrumb, atau node apapun.
+     * String dibungkus otomatis jadi `<Text>`.
+     */
+    title?: ReactNode;
+    /**
+     * Aksi di sisi kanan header bar, dirender sebelum tombol resize & close.
+     * Mis. tombol Favorite / Ask AI / navigasi prev-next.
+     */
+    headerAction?: ReactNode;
+    /**
+     * Matikan header bar sepenuhnya (tanpa border & tanpa tombol close).
+     * Default `true`.
+     */
+    header?: boolean;
+    /**
+     * Preset lebar yang bisa diputar lewat tombol di header. Isi minimal 2
+     * nilai untuk mengaktifkannya — tombolnya muncul di sisi kanan header,
+     * sebelum tombol close. Preset awal diambil dari `width` kalau nilainya
+     * ada di daftar, kalau tidak dari elemen pertama.
+     *
+     * Butuh `header` aktif — tombolnya tinggal di header bar.
+     */
+    widthPresets?: CSSProperties["width"][];
+    /**
+     * Drag-to-resize lewat handle di tepi kiri panel. Default `true`.
+     * Otomatis mati di mobile (< 768px) — drag di layar sentuh bentrok dengan
+     * gestur swipe, dan lebar panel di sana praktis selalu penuh.
+     */
+    resizable?: boolean;
+    /** Lebar minimum saat di-drag, dalam px. Default `320`. */
+    resizeMin?: number;
+    /**
+     * Lebar maksimum saat di-drag, dalam px. Default lebar viewport
+     * (panel tetap di-clamp oleh CSS `max-width` milik Drawer).
+     */
+    resizeMax?: number;
+    /**
+     * Dipanggil saat lebar berubah — setelah drag selesai (bukan tiap frame)
+     * dan saat preset berganti. Lebarnya disimpan internal (uncontrolled);
+     * pakai callback ini kalau mau persist sendiri, dan beri key per konteks:
+     * lebar yang pas untuk drawer filter belum tentu pas untuk drawer detail.
+     */
+    onWidthChange?: (width: CSSProperties["width"]) => void;
 }
 /**
- * Lebar panel sekarang di-set via prop `size` milik Drawer (bukan inline
- * `style` + helper clamp manual). Drawer's CSS `max-width: calc(100vw - 16px)`
- * yang otomatis meng-clamp ke viewport, jadi tidak perlu `min(...)` lagi.
+ * Lebar panel di-set via prop `size` milik Drawer (bukan inline `style` +
+ * helper clamp manual). Drawer's CSS `max-width: calc(100vw - 16px)` yang
+ * otomatis meng-clamp ke viewport, jadi tidak perlu `min(...)` lagi.
  * `width`/`minWidth`/`maxWidth` dipertahankan untuk backward-compat call site.
+ *
+ * Tiga cara mengatur lebar, prioritas dari atas:
+ *   1. drag handle  → menang selama sesi drawer terbuka
+ *   2. `widthPresets` → klik preset menghapus hasil drag
+ *   3. `width` / `maxWidth` / `minWidth` → nilai awal
+ *
+ * `paddingHorizontal` sebelumnya ada di type tapi tidak pernah dipakai —
+ * sekarang benar-benar mengontrol padding kiri/kanan body (default `true`,
+ * jadi perilaku lama tidak berubah).
+ *
+ * Header bar tingginya mengikuti `--app-header-height` supaya sejajar dengan
+ * header AppLayout. AppLayout mem-publish var itu ke `<html>` justru karena
+ * Drawer di-portal ke `document.body` — di luar subtree AppLayout, jadi var
+ * yang di-set di root-nya tidak terwarisi. Fallback `44px` dipakai kalau
+ * RightDrawer dipakai di luar AppLayout.
  */
 export declare const RightDrawer: React.ForwardRefExoticComponent<RightDrawerProps & React.RefAttributes<HTMLDivElement>>;
 export {};

package/dist/components/SidePanel/index.d.ts

@@ -27,7 +27,7 @@ export interface SidePanelProps {
     width?: number;
     /** Which edge the panel hugs (and where the toggle "ear" sits). @default 'left' */
     side?: "left" | "right";
-    /** Distance from the top of the viewport for sticky positioning. @default '4rem' */
+    /** Distance from the top of the viewport for sticky positioning. @default 'var(--app-header-height, 4rem)' (AppLayout header height) */
     offsetTop?: number | string;
     /** Panel height. @default 'calc(100vh - {offsetTop})' */
     height?: number | string;

package/dist/components/TableSection/components/TableSection.d.ts

@@ -1,4 +1,15 @@
 import { default as React } from 'react';
 import { BaseRecord, TableSectionProps } from '../types';
 
+/**
+ * Template tabel + header + footer pagination dalam satu komponen.
+ *
+ * @deprecated Digantikan oleh `<FilterBar>` + `<TableLayout>` yang memisahkan
+ * kontrol filter dari tabel, mendukung row selection, kolom yang bisa
+ * di-customize, saved views, dan layout mobile. Panduan migrasi ada di skill
+ * `starasia-list-page-pattern`.
+ *
+ * Masih berfungsi penuh, tapi tidak lagi menerima fitur baru dan akan dihapus
+ * di `@starasia/admin@13.0.0`.
+ */
 export declare const TableSection: <T extends BaseRecord>({ wrapperProps, dataTableProps, headerProps, footerProps }: TableSectionProps<T>) => React.JSX.Element;

package/dist/components/TableSection/index.d.ts

@@ -1,3 +1,14 @@
+/**
+ * ⚠️ Pattern tabel LAMA — deprecated, akan dihapus di `@starasia/admin@13.0.0`.
+ *
+ * Untuk halaman list baru pakai `<FilterBar>` + `<TableLayout>` (skill
+ * `starasia-list-page-pattern`). Sub-komponen di bawah (`TableWrapper`,
+ * `TableHeader`, `TableFooter`, `DataTable`, `ColumnFilterDropdown`) adalah
+ * bagian dari pattern ini dan ikut dihapus bersamanya.
+ *
+ * Catatan: `./types` masih dipakai pattern baru (mis. tipe `Pagination` yang
+ * di-import `FilterBar`), jadi modul tipe-nya sendiri TIDAK deprecated.
+ */
 export { TableSection } from './components/TableSection';
 export { TableWrapper } from './components/Wrapper';
 export { TableHeader } from './components/Header';

package/dist/components/TableSection/types.d.ts

@@ -117,6 +117,9 @@ export type TableFooterProps = {
     showFooter?: boolean;
     totalData?: number;
 };
+/**
+ * @deprecated Ikut `TableSection`. Pakai props `<FilterBar>` + `<TableLayout>`.
+ */
 export type TableSectionProps<T extends BaseRecord> = {
     headerProps?: TableHeaderProps;
     wrapperProps?: Omit<WrapperProps, 'children'>;

package/dist/entries/App/sidebar.d.ts

@@ -1,13 +1,14 @@
 import { default as React, PropsWithChildren } from 'react';
 
-/** Default expanded sidebar width in px (16.375rem). */
-export declare const SIDEBAR_DEFAULT_WIDTH = 262;
+/** Default expanded sidebar width in px (15rem). */
+export declare const SIDEBAR_DEFAULT_WIDTH = 240;
 /**
- * Smallest draggable expanded width in px. Equal to the default — the sidebar
- * can be dragged WIDER than its default, never narrower. (To collapse, use the
- * toggle or drag past the snap threshold.)
+ * Smallest draggable expanded width in px. Sengaja SAMA dengan
+ * `SIDEBAR_SNAP_COLLAPSE_THRESHOLD` di AppLayout: menyeret sampai batas ini
+ * masih menyisakan sidebar, sedikit lebih sempit dari itu langsung snap ke
+ * icon rail — tanpa zona mati di antaranya.
  */
-export declare const SIDEBAR_MIN_WIDTH = 262;
+export declare const SIDEBAR_MIN_WIDTH = 200;
 /** Largest draggable expanded width in px. */
 export declare const SIDEBAR_MAX_WIDTH = 480;
 export interface SidebarContextValue {