@starasia/admin 1.3.4 → 1.4.0

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

@@ -6,7 +6,7 @@ export interface Option {
     label: string;
     value: string;
 }
-export type InputType = "dropdown" | "text" | "date" | "select-button" | "date-range";
+export type InputType = "dropdown" | "text" | "date" | "select-button" | "date-range" | "checkbox";
 export type ChangeHandler = (params: {
     value: any;
     name?: string;

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

@@ -1,5 +1,16 @@
 import { default as React, ReactNode } from 'react';
+import { IconName } from '@starasia/icon';
+import { SidebarHeaderSlotChildren } from '../SidebarHeaderSlot';
 
+/**
+ * Item tombol di profile menu body. Multiple item bisa di-pass via
+ * `profileMenuButtons` di AppLayout.
+ */
+export interface ProfileMenuButton {
+    icon: IconName;
+    label: string;
+    onClick: () => void;
+}
 interface AppLayoutProps {
     children?: ReactNode;
     profile?: {
@@ -12,14 +23,39 @@ interface AppLayoutProps {
     isLoggingOut?: boolean;
     loadingComponent?: ReactNode;
     /**
-     * Content untuk sidebar header slot (dibawah logo)
-     * Dapat berupa: Organization Menu, User Switcher, Custom Component, atau kombinasinya
+     * Content untuk sidebar header slot (dibawah logo).
+     * Boleh ReactNode (auto-hide saat sidebar collapse), atau render function
+     * `({ collapsed }) => ReactNode` agar caller bisa render alternatif saat
+     * collapse (mis. tampilkan hanya logo).
+     */
+    sidebarHeaderContent?: SidebarHeaderSlotChildren;
+    /**
+     * Slot untuk komponen aksi di sisi kanan header (sebelum profile/user info).
+     * Caller compose sendiri — mis. `<><NotificationBell /><ModuleSwitcher /></>`.
+     */
+    headerActions?: ReactNode;
+    /**
+     * Optional: role/jabatan yang ditampilkan di profile menu heading.
+     */
+    profileRole?: string;
+    /**
+     * 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.
+     */
+    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.
      */
-    sidebarHeaderContent?: ReactNode;
+    profileMenuItems?: ReactNode;
     /**
-     * Show/hide module switcher control in header (and its modal)
+     * Optional: override total item Logout di footer. Kalau di-set, footer
+     * default (Logout button + dialog konfirmasi) tidak dirender — caller
+     * bertanggung jawab penuh atas footer & handler logout.
      */
-    showModuleSwitcher?: boolean;
+    logoutButton?: ReactNode;
 }
 /**
  * AppLayout - Main application layout component based on workspace pattern
@@ -27,12 +63,12 @@ interface AppLayoutProps {
  * - Responsive sidebar with collapse/expand (mobile: full-width + overlay)
  * - Accordion menu items with auto-expansion
  * - Sidebar scroll position persistence
- * - Module switcher modal with localStorage
- * - Settings shortcuts dropdown
+ * - Filter sidebar by selected module (via shared useModuleSelection)
  * - User profile & logout dialog
  * - Mobile hamburger menu
  * - Loading overlay support
  * - Embed mode for iframes
+ * - Header actions slot for caller-composed controls (e.g. ModuleSwitcher)
  */
-export declare function AppLayout({ children, headerRight, profile, isLoadingProfile, onLogout, isLoggingOut, loadingComponent, sidebarHeaderContent, showModuleSwitcher, }: AppLayoutProps): React.JSX.Element;
+export declare function AppLayout({ children, headerRight, profile, isLoadingProfile, onLogout, isLoggingOut, loadingComponent, sidebarHeaderContent, headerActions, profileRole, profileMenuButtons, profileMenuItems, logoutButton, }: AppLayoutProps): React.JSX.Element;
 export {};

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

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+
+export interface ModuleSwitcherProps {
+    /**
+     * Optional callback fired after the selection changes. Useful for
+     * analytics or side-effects beyond default navigation.
+     */
+    onSelect?: (id: number | null) => void;
+    "aria-label"?: string;
+}
+/**
+ * ModuleSwitcher - Header action that opens the ModuleSwitcherModal.
+ *
+ * Self-contained: reads `app.menus` via `useApp()`, persists the active
+ * group id via `useModuleSelection()` (localStorage + cross-component sync).
+ * Selecting a group navigates to its first menu item.
+ */
+export declare function ModuleSwitcher({ onSelect, "aria-label": ariaLabel, }?: ModuleSwitcherProps): React.JSX.Element;

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

@@ -1,31 +1,35 @@
 import { default as React, ReactNode } from 'react';
 
+export interface SidebarHeaderSlotRenderProps {
+    collapsed: boolean;
+}
+export type SidebarHeaderSlotChildren = ReactNode | ((state: SidebarHeaderSlotRenderProps) => ReactNode);
 export interface SidebarHeaderSlotProps {
     /**
      * Collapsed state from sidebar
      */
     collapsed?: boolean;
     /**
-     * Content to display below logo - dapat berupa:
-     * - Organization menu
-     * - User switcher
-     * - Custom component
-     * - Atau kombinasi dari beberapa komponen
+     * Content to display below logo. Boleh berupa:
+     * - ReactNode biasa — slot akan auto-hide (visibility: hidden) saat collapsed.
+     * - Render function `(state) => ReactNode` — caller punya kontrol penuh
+     *   atas tampilan tiap state (mis. tampilkan hanya logo saat collapsed).
      */
-    children?: ReactNode;
+    children?: SidebarHeaderSlotChildren;
 }
 /**
  * SidebarHeaderSlot - Flexible slot area dibawah logo sidebar
- * Digunakan untuk menempatkan komponen apapun yang relevan dengan sidebar header
  *
- * Contoh penggunaan:
- * <SidebarHeaderSlot collapsed={sidebarCollapsed}>
- *   <OrganizationMenu />
- * </SidebarHeaderSlot>
+ * Render-prop usage (recommended saat butuh tampilan beda saat collapse):
+ *
+ *   <SidebarHeaderSlot collapsed={collapsed}>
+ *     {({ collapsed }) => (collapsed ? <LogoOnly /> : <FullHeader />)}
+ *   </SidebarHeaderSlot>
+ *
+ * ReactNode usage (auto-hide saat collapsed, ruang tetap dipertahankan):
  *
- * atau:
- * <SidebarHeaderSlot collapsed={sidebarCollapsed}>
- *   <UserSwitcher />
- * </SidebarHeaderSlot>
+ *   <SidebarHeaderSlot collapsed={collapsed}>
+ *     <OrganizationMenu />
+ *   </SidebarHeaderSlot>
  */
 export declare function SidebarHeaderSlot({ collapsed, children, }: SidebarHeaderSlotProps): React.JSX.Element | null;

package/dist/components/index.d.ts

@@ -1,6 +1,7 @@
 export * from './AppLayout';
 export * from './SidebarHeaderSlot';
 export * from './ModuleSwitcherModal';
+export * from './ModuleSwitcher';
 export * from './AuthLayout';
 export * from './HorizontalField';
 export * from './ModalDialog';

package/dist/hooks/index.d.ts

@@ -3,3 +3,4 @@ export * from './useDynamicTitle';
 export * from './useRouteParams';
 export * from './useRouteInfo';
 export * from './useAuthRole';
+export * from './useModuleSelection';

package/dist/hooks/useModuleSelection.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared state for the active module/group selected via ModuleSwitcher.
+ * Backed by localStorage; synced across components in the same tab via
+ * a custom event, and across tabs via the native `storage` event.
+ */
+export declare function useModuleSelection(): {
+    selectedGroupId: number | null;
+    setSelectedGroupId: (id: number | null) => void;
+};