@juv/codego-react-ui 3.5.21 → 3.6.0

package/README.md

@@ -619,6 +619,14 @@ function AnnouncementsPage() {
 }
 ```
 
+> **Note:** `useServerBulletin` uses the internal `codego` api client which automatically attaches the Bearer token from `localStorage.getItem("token")`. For encrypted Laravel responses, pass `encrypt: true` and set `VITE_LARAVEL_KEY` in your `.env`:
+>
+> ```
+> VITE_LARAVEL_KEY=base64:your_app_key_here
+> ```
+>
+> Or pass the key directly: `key: "base64:..."`. The response can be a plain array `[...]` or a paginated object `{ data: [...], total, per_page, ... }` — both are handled automatically.
+
 ---
 
 ## LeafletMap Props
@@ -731,6 +739,53 @@ function AnnouncementsPage() {
 
 ---
 
+## Laravel Response Decryption
+
+Use `decryptResponse` to decrypt Laravel-encrypted API responses (AES-256-CBC).
+
+### Setup
+
+Add your Laravel `APP_KEY` to `.env`:
+
+```env
+VITE_LARAVEL_KEY=base64:your_laravel_app_key_here
+```
+
+### Usage
+
+```tsx
+import { api, decryptResponse } from "@juv/codego-react-ui"
+
+type Certificate = { id: number; name: string }
+
+const fetchCertificates = async () => {
+  const data = await api.get<string>('/certificate')
+  const decoded = decryptResponse<Certificate[]>(data)
+  console.log(decoded)
+}
+```
+
+> `api.get` should be typed as `string` since the raw response is an encrypted payload. `decryptResponse` reads `VITE_LARAVEL_KEY` automatically.
+
+You can also pass the key explicitly:
+
+```tsx
+const decoded = decryptResponse<Certificate[]>(data, "base64:your_key_here")
+```
+
+### API
+
+| Export | Description |
+|---|---|
+| `decryptResponse(response, key?)` | Decrypts a Laravel-encrypted string or `{ data: string }` object. |
+| `decryptLaravelPayload(payload, key?)` | Low-level decryption of a raw encrypted payload string. |
+| `getLaravelSecretKey()` | Reads the key from `VITE_LARAVEL_KEY`, `REACT_APP_LARAVEL_KEY`, or `window.__LARAVEL_KEY__`. |
+| `parseLaravelKey(secretKey)` | Parses a `base64:...` or raw key string into a `CryptoJS.WordArray`. |
+| `parseLaravelEncryptedPayload(payload)` | Parses a base64-encoded Laravel encrypted payload into `{ iv, value, mac }`. |
+| `LaravelEncryptedPayload` | Type for the parsed payload object. |
+
+---
+
 ## Run Locally
 
 **Prerequisites:** Node.js

package/dist/index.cjs

@@ -127,7 +127,11 @@ __export(index_exports, {
   Wizard: () => Wizard,
   api: () => api,
   createStore: () => createStore,
-  useServerBulletin: () => useServerBulletin,
+  decryptLaravelPayload: () => decryptLaravelPayload,
+  decryptResponse: () => decryptResponse,
+  getLaravelSecretKey: () => getLaravelSecretKey,
+  parseLaravelEncryptedPayload: () => parseLaravelEncryptedPayload,
+  parseLaravelKey: () => parseLaravelKey,
   useServerDataGrid: () => useServerDataGrid,
   useServerTable: () => useServerTable,
   useTheme: () => useTheme,
@@ -1559,66 +1563,6 @@ var React8 = __toESM(require("react"), 1);
 var import_react_dom = require("react-dom");
 var import_axios2 = __toESM(require("axios"), 1);
 var import_lucide_react4 = require("lucide-react");
-
-// src/components/tools/decryptPayload.ts
-var import_crypto_js = __toESM(require("crypto-js"), 1);
-function getLaravelSecretKey() {
-  const viteKey = (() => {
-    try {
-      return new Function("return import.meta.env")();
-    } catch {
-      return void 0;
-    }
-  })()?.VITE_LARAVEL_KEY;
-  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
-  const windowKey = globalThis?.__LARAVEL_KEY__;
-  const key = viteKey || legacyKey || windowKey;
-  if (!key) {
-    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
-  }
-  return key;
-}
-function parseLaravelKey(secretKey) {
-  if (secretKey.startsWith("base64:")) {
-    return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
-  }
-  return import_crypto_js.default.enc.Utf8.parse(secretKey);
-}
-function parseLaravelEncryptedPayload(payload) {
-  let jsonStr = payload;
-  try {
-    jsonStr = atob(payload);
-  } catch {
-  }
-  return JSON.parse(jsonStr);
-}
-function decryptLaravelPayload(payload, secretKey) {
-  const resolvedKey = secretKey ?? getLaravelSecretKey();
-  const parsed = parseLaravelEncryptedPayload(payload);
-  if (parsed.tag) {
-    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
-  }
-  const key = parseLaravelKey(resolvedKey);
-  const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
-  if (expectedMac !== parsed.mac) {
-    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
-  }
-  const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
-  const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
-  const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
-  const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
-    iv,
-    mode: import_crypto_js.default.mode.CBC,
-    padding: import_crypto_js.default.pad.Pkcs7
-  });
-  const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
-  if (!plaintext) {
-    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
-  }
-  return JSON.parse(plaintext);
-}
-
-// src/components/ui/bulletin-board.tsx
 var import_jsx_runtime10 = require("react/jsx-runtime");
 var PRIORITY_CONFIG = {
   urgent: { label: "Urgent", icon: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_lucide_react4.AlertCircle, { className: "h-3 w-3" }), badge: "error" },
@@ -1648,82 +1592,13 @@ function AuthorAvatar({ item }) {
   }
   return null;
 }
-function useServerBulletin({
-  url,
-  params,
-  encrypt,
-  key,
-  decryptPayloadLog,
-  transform
-}) {
-  const [items, setItems] = React8.useState([]);
-  const [currentPage, setCurrentPage] = React8.useState(1);
-  const [pagination, setPagination] = React8.useState(null);
-  const [loading, setLoading] = React8.useState(false);
-  const [error, setError] = React8.useState(null);
-  const [tick, setTick] = React8.useState(0);
-  React8.useEffect(() => {
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-    import_axios2.default.get(url, { params: { ...params, page: currentPage } }).then(({ data: res }) => {
-      if (cancelled) return;
-      let payload;
-      try {
-        payload = encrypt ? decryptLaravelPayload(res, key) : res;
-      } catch (decryptErr) {
-        console.error("[useServerBulletin] decryption failed:", decryptErr?.message ?? decryptErr);
-        if (!cancelled) setError(decryptErr?.message ?? "Decryption failed");
-        return;
-      }
-      if (encrypt && decryptPayloadLog) console.log("[useServerBulletin] decrypted:", payload);
-      const rows = Array.isArray(payload) ? payload : payload.data ?? [];
-      setItems(transform ? rows.map(transform) : rows);
-      if (!Array.isArray(payload)) {
-        const rawTotal = payload.total;
-        const rawPerPage = payload.per_page;
-        const rawLastPage = payload.last_page;
-        const lastPage = rawLastPage ?? Math.ceil(rawTotal / rawPerPage);
-        const pg = payload.pagination ?? {
-          first_page_url: payload.first_page_url ?? `${url}?page=1`,
-          last_page_url: payload.last_page_url ?? `${url}?page=${lastPage}`,
-          last_page: lastPage,
-          next_page_url: payload.next_page_url !== void 0 ? payload.next_page_url : currentPage < lastPage ? `${url}?page=${currentPage + 1}` : null,
-          prev_page_url: payload.prev_page_url !== void 0 ? payload.prev_page_url : currentPage > 1 ? `${url}?page=${currentPage - 1}` : null,
-          per_page: rawPerPage,
-          total: rawTotal,
-          links: payload.links ?? []
-        };
-        setPagination(pg);
-      }
-    }).catch((err) => {
-      if (cancelled) return;
-      setError(err?.response?.data?.message ?? err.message ?? "Request failed");
-    }).finally(() => {
-      if (!cancelled) setLoading(false);
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [url, currentPage, tick, JSON.stringify(params), encrypt, decryptPayloadLog]);
-  return {
-    items,
-    currentPage,
-    pagination,
-    serverPagination: pagination ? { pagination, currentPage, goToPage: (p) => setCurrentPage(p) } : null,
-    loading,
-    error,
-    goToPage: (p) => setCurrentPage(p),
-    reload: () => setTick((t) => t + 1)
-  };
-}
-function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
   const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
   return (0, import_react_dom.createPortal)(
     /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.55)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -1736,7 +1611,8 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
                 " Pinned"
               ] }),
               priority && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-              item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category })
+              item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category }),
+              headerAction
             ] }),
             /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-1 shrink-0", children: [
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -1835,6 +1711,7 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
               ] })
             ] }) }),
             /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-2", children: [
+              footerAction,
               onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
                 "button",
                 {
@@ -2229,6 +2106,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React8.useState(null);
@@ -2313,6 +2193,7 @@ function BulletinBoard({
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(import_lucide_react4.Pin, { className: "h-8 w-8 opacity-20" }),
       emptyMessage
     ] }) : layout === "list" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+    footerAction && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { children: footerAction }),
     serverPagination && (() => {
       const { pagination, currentPage: cp, goToPage } = serverPagination;
       const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -2389,7 +2270,9 @@ function BulletinBoard({
           setDeleteItem(item);
         } : onDelete ? (item) => {
           onDelete(item);
-        } : void 0
+        } : void 0,
+        footerAction: footerPreviewAction ? footerPreviewAction(previewItem) : void 0,
+        headerAction: headerPreviewAction
       }
     ),
     editItem && editBaseUrl && editFields && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -3863,6 +3746,66 @@ function MetricRow({ items, divided = true, className }) {
 // src/components/ui/data-grid.tsx
 var React29 = __toESM(require("react"), 1);
 var import_react_dom3 = require("react-dom");
+
+// src/components/tools/decryptPayload.ts
+var import_crypto_js = __toESM(require("crypto-js"), 1);
+function getLaravelSecretKey() {
+  const viteKey = (() => {
+    try {
+      return new Function("return import.meta.env")();
+    } catch {
+      return void 0;
+    }
+  })()?.VITE_LARAVEL_KEY;
+  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
+  const windowKey = globalThis?.__LARAVEL_KEY__;
+  const key = viteKey || legacyKey || windowKey;
+  if (!key) {
+    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
+  }
+  return key;
+}
+function parseLaravelKey(secretKey) {
+  if (secretKey.startsWith("base64:")) {
+    return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
+  }
+  return import_crypto_js.default.enc.Utf8.parse(secretKey);
+}
+function parseLaravelEncryptedPayload(payload) {
+  let jsonStr = payload;
+  try {
+    jsonStr = atob(payload);
+  } catch {
+  }
+  return JSON.parse(jsonStr);
+}
+function decryptLaravelPayload(payload, secretKey) {
+  const resolvedKey = secretKey ?? getLaravelSecretKey();
+  const parsed = parseLaravelEncryptedPayload(payload);
+  if (parsed.tag) {
+    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
+  }
+  const key = parseLaravelKey(resolvedKey);
+  const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
+  if (expectedMac !== parsed.mac) {
+    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
+  }
+  const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
+  const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
+  const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
+  const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
+    iv,
+    mode: import_crypto_js.default.mode.CBC,
+    padding: import_crypto_js.default.pad.Pkcs7
+  });
+  const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
+  if (!plaintext) {
+    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
+  }
+  return JSON.parse(plaintext);
+}
+
+// src/components/ui/data-grid.tsx
 var import_axios4 = __toESM(require("axios"), 1);
 var import_lucide_react18 = require("lucide-react");
 
@@ -6806,7 +6749,7 @@ function ModalShell({ title, onClose, children, footer, width = "lg" }) {
     /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.5)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -13817,6 +13760,12 @@ function createStore(initialValue, sessionName, expireInterval) {
   };
   return { store, getStore };
 }
+
+// src/core/decryption/decode.ts
+function decryptResponse(response, key) {
+  const payload = typeof response === "string" ? response : response.data;
+  return decryptLaravelPayload(payload, key);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Accordion,
@@ -13917,7 +13866,11 @@ function createStore(initialValue, sessionName, expireInterval) {
   Wizard,
   api,
   createStore,
-  useServerBulletin,
+  decryptLaravelPayload,
+  decryptResponse,
+  getLaravelSecretKey,
+  parseLaravelEncryptedPayload,
+  parseLaravelKey,
   useServerDataGrid,
   useServerTable,
   useTheme,

package/dist/index.d.cts

@@ -3,6 +3,7 @@ import * as React from 'react';
 import React__default from 'react';
 import { AxiosRequestConfig } from 'axios';
 import { UseBoundStore, StoreApi } from 'zustand';
+import CryptoJS from 'crypto-js';
 
 type AuthView = "login" | "register" | "resetPassword";
 interface AuthField {
@@ -810,26 +811,6 @@ interface BulletinServerPaginationProp {
     currentPage: number;
     goToPage: (page: number) => void;
 }
-interface UseServerBulletinOptions {
-    url: string;
-    params?: Record<string, string | number>;
-    encrypt?: boolean;
-    key?: string;
-    decryptPayloadLog?: boolean;
-    /** Map raw API row → BulletinItem */
-    transform?: (row: any) => BulletinItem;
-}
-interface UseServerBulletinReturn {
-    items: BulletinItem[];
-    currentPage: number;
-    pagination: ServerPagination | null;
-    serverPagination: BulletinServerPaginationProp | null;
-    loading: boolean;
-    error: string | null;
-    goToPage: (page: number) => void;
-    reload: () => void;
-}
-declare function useServerBulletin({ url, params, encrypt, key, decryptPayloadLog, transform, }: UseServerBulletinOptions): UseServerBulletinReturn;
 interface BulletinPreviewProps {
     item: BulletinItem;
     onClose: () => void;
@@ -838,8 +819,12 @@ interface BulletinPreviewProps {
     onView?: (item: BulletinItem) => void;
     /** Custom actions to add to the preview header */
     customActions?: BulletinAction[];
+    /** Extra React elements rendered in the preview modal header's left area */
+    headerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area */
+    footerAction?: React.ReactNode;
 }
-declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }: BulletinPreviewProps): React.ReactPortal;
+declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }: BulletinPreviewProps): React.ReactPortal;
 interface BulletinEditField {
     key: keyof BulletinItem | string;
     label: string;
@@ -898,10 +883,16 @@ interface BulletinBoardProps {
     serverPagination?: BulletinServerPaginationProp | null;
     /** Fired when a post card is clicked (ignored when preview=true). */
     onItemClick?: (item: BulletinItem) => void;
+    /** Extra React elements rendered below the board content (above pagination). */
+    footerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal header's left area. */
+    headerPreviewAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area. */
+    footerPreviewAction?: (item: BulletinItem) => React.ReactNode;
     /** Additional CSS classes on the outer wrapper. */
     className?: string;
 }
-declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
+declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, footerAction, headerPreviewAction, footerPreviewAction, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
@@ -2561,4 +2552,29 @@ type StoreWrapper<T extends object> = {
  */
 declare function createStore<T extends object>(initialValue: T, sessionName: string, expireInterval?: number): StoreWrapper<T>;
 
-export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };
+type LaravelEncryptedPayload = {
+    iv: string;
+    value: string;
+    mac: string;
+    tag?: string;
+};
+declare function getLaravelSecretKey(): string;
+declare function parseLaravelKey(secretKey: string): CryptoJS.lib.WordArray;
+declare function parseLaravelEncryptedPayload(payload: string): LaravelEncryptedPayload;
+declare function decryptLaravelPayload<T>(payload: string, secretKey?: string): T;
+
+/**
+ * Decrypt a Laravel-encrypted API response.
+ *
+ * Accepts either:
+ *  - a raw encrypted string (the full response body)
+ *  - an object with an `data` key holding the encrypted string
+ *
+ * @param response  Raw encrypted string or `{ data: string }` object
+ * @param key       Optional Laravel APP_KEY (base64:… or raw). Falls back to VITE_LARAVEL_KEY.
+ */
+declare function decryptResponse<T = unknown>(response: string | {
+    data: string;
+}, key?: string): T;
+
+export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, type LaravelEncryptedPayload, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, decryptLaravelPayload, decryptResponse, getLaravelSecretKey, parseLaravelEncryptedPayload, parseLaravelKey, useServerDataGrid, useServerTable, useTheme, useToast, useToc };

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import * as React from 'react';
 import React__default from 'react';
 import { AxiosRequestConfig } from 'axios';
 import { UseBoundStore, StoreApi } from 'zustand';
+import CryptoJS from 'crypto-js';
 
 type AuthView = "login" | "register" | "resetPassword";
 interface AuthField {
@@ -810,26 +811,6 @@ interface BulletinServerPaginationProp {
     currentPage: number;
     goToPage: (page: number) => void;
 }
-interface UseServerBulletinOptions {
-    url: string;
-    params?: Record<string, string | number>;
-    encrypt?: boolean;
-    key?: string;
-    decryptPayloadLog?: boolean;
-    /** Map raw API row → BulletinItem */
-    transform?: (row: any) => BulletinItem;
-}
-interface UseServerBulletinReturn {
-    items: BulletinItem[];
-    currentPage: number;
-    pagination: ServerPagination | null;
-    serverPagination: BulletinServerPaginationProp | null;
-    loading: boolean;
-    error: string | null;
-    goToPage: (page: number) => void;
-    reload: () => void;
-}
-declare function useServerBulletin({ url, params, encrypt, key, decryptPayloadLog, transform, }: UseServerBulletinOptions): UseServerBulletinReturn;
 interface BulletinPreviewProps {
     item: BulletinItem;
     onClose: () => void;
@@ -838,8 +819,12 @@ interface BulletinPreviewProps {
     onView?: (item: BulletinItem) => void;
     /** Custom actions to add to the preview header */
     customActions?: BulletinAction[];
+    /** Extra React elements rendered in the preview modal header's left area */
+    headerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area */
+    footerAction?: React.ReactNode;
 }
-declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }: BulletinPreviewProps): React.ReactPortal;
+declare function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }: BulletinPreviewProps): React.ReactPortal;
 interface BulletinEditField {
     key: keyof BulletinItem | string;
     label: string;
@@ -898,10 +883,16 @@ interface BulletinBoardProps {
     serverPagination?: BulletinServerPaginationProp | null;
     /** Fired when a post card is clicked (ignored when preview=true). */
     onItemClick?: (item: BulletinItem) => void;
+    /** Extra React elements rendered below the board content (above pagination). */
+    footerAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal header's left area. */
+    headerPreviewAction?: React.ReactNode;
+    /** Extra React elements rendered in the preview modal footer's action area. */
+    footerPreviewAction?: (item: BulletinItem) => React.ReactNode;
     /** Additional CSS classes on the outer wrapper. */
     className?: string;
 }
-declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
+declare function BulletinBoard({ items, layout, columns, variant, searchable, filterable, categories: categoriesProp, title, headerAction, showHeader, emptyMessage, loading, loadingCount, onItemClick, onView, onEdit, onDelete, preview, editBaseUrl, editMethod, editIdKey, editFields, deleteBaseUrl, deleteIdKey, serverPagination, footerAction, headerPreviewAction, footerPreviewAction, className, }: BulletinBoardProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "primary" | "secondary" | "outline" | "ghost" | "link" | "danger" | "success" | "destructive";
@@ -2561,4 +2552,29 @@ type StoreWrapper<T extends object> = {
  */
 declare function createStore<T extends object>(initialValue: T, sessionName: string, expireInterval?: number): StoreWrapper<T>;
 
-export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerBulletinOptions, type UseServerBulletinReturn, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, useServerBulletin, useServerDataGrid, useServerTable, useTheme, useToast, useToc };
+type LaravelEncryptedPayload = {
+    iv: string;
+    value: string;
+    mac: string;
+    tag?: string;
+};
+declare function getLaravelSecretKey(): string;
+declare function parseLaravelKey(secretKey: string): CryptoJS.lib.WordArray;
+declare function parseLaravelEncryptedPayload(payload: string): LaravelEncryptedPayload;
+declare function decryptLaravelPayload<T>(payload: string, secretKey?: string): T;
+
+/**
+ * Decrypt a Laravel-encrypted API response.
+ *
+ * Accepts either:
+ *  - a raw encrypted string (the full response body)
+ *  - an object with an `data` key holding the encrypted string
+ *
+ * @param response  Raw encrypted string or `{ data: string }` object
+ * @param key       Optional Laravel APP_KEY (base64:… or raw). Falls back to VITE_LARAVEL_KEY.
+ */
+declare function decryptResponse<T = unknown>(response: string | {
+    data: string;
+}, key?: string): T;
+
+export { Accordion, type AccordionItem, type AccordionProps, type AccordionVariant, type ActionField, type ActionFieldType, type AuthField, type AuthVariant, type AuthView, Authentication, type AuthenticationProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, type BadgeSize, type BadgeVariant, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BulletinAction, BulletinBoard, type BulletinBoardProps, type BulletinColumns, type BulletinEditField, type BulletinItem, type BulletinLayout, BulletinPreview, type BulletinPreviewProps, type BulletinPriority, type BulletinServerPaginationProp, type BulletinVariant, Button, type ButtonProps, COLOR_PALETTE, Calendar, CalendarDateRangePicker, type CalendarDateRangePickerProps, type CalendarDateRangeVariant, type CalendarEvent, type CalendarProps, type CalendarView, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, ChartWidget, type ChartWidgetProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, type ClusterVariant, CodegoApiProvider, ColorPicker, type ColorPickerProps, type Column, Combobox, type ComboboxOption, type ComboboxProps, type CommandItem, CommandPalette, type CommandPaletteProps, ComposableWidget, type ComposableWidgetProps, type ConfirmVariant, ContextMenu, type ContextMenuItem, type ContextMenuProps, DataGrid, type DataGridColumn, type DataGridProps, DatePickerPopup, type DateRange, DateRangePicker, type DateRangePickerProps, type DefaultActionsConfig, DocsLayout, Drawer, type DrawerProps, type DrawerSide, Dropdown, DropdownItem, DropdownLabel, type DropdownProps, DropdownSeparator, EVENT_COLORS, type FileTypeValidation, FileUpload, type FileUploadProps, type FlexAlign, type FlexDirection, type FlexGap, FlexItem, type FlexItemProps, type FlexJustify, FlexLayout, type FlexLayoutProps, type FlexWrap, type FlyToOptions, type FormField, type FormFieldType, type GridAlign, type GridCols, type GridGap, GridItem, type GridItemProps, GridLayout, type GridLayoutProps, GroupNavigation, type GroupNavigationProps, type ImageEditorMode, type ImageEditorOptions, Input, type InputProps, KanbanBoard, type KanbanBoardProps, type KanbanCard, type KanbanColumn, Label, type LaravelEncryptedPayload, LeafletMap, type LeafletMapProps, LeftSidebar, type LeftSidebarProps, type MapLibreClusterVariant, MapLibreMap, type MapLibreMarker, type MapLibreProps, type MapLibreRoute, type MapLibreRouteType, type MapLibreStyle, type MapMarker, type MapRoute, type MarkerColor, type MetricItem, MetricRow, type MetricRowProps, Modal, ModalConfirmation, type ModalConfirmationProps, type ModalProps, ModalUnchange, type ModalUnchangeProps, ModalWithForms, type ModalWithFormsProps, type NavGroup, type NavItem, Navigation, type NavigationProps, NotificationBanner, type NotificationBannerProps, type NotificationItem, NotificationPanel, type NotificationPanelProps, type NotificationVariant, OtpInput, type OtpInputProps, Pagination, type PaginationProps, Panel, type PanelProps, PanelSettings, type PanelSettingsProps, type PanelSettingsTab, PanelSidebarGroup, PanelSidebarItem, Popover, type PopoverPlacement, type PopoverProps, Progress, type ProgressProps, type ProgressSize, type ProgressVariant, type PropRow, PropsTable, RadioGroup, type RadioGroupProps, type RadioOption, type RadioSize, type RadioVariant, RangeSlider, type RangeSliderProps, Repeater, type RepeaterProps, type RequestConfig, ResizablePanels, type ResizablePanelsProps, RichTextEditor, type RichTextEditorProps, RightSidebar, type RightSidebarProps, type RouteType, ScrollArea, type ScrollAreaProps, Section, SectionBlock, type SectionProps, type SectionVariant, Select, type SelectOption, type SelectProps, type SemanticColor, type ServerDataGridProp, type ServerPagination, type ServerPaginationLink, type ServerPaginationProp, type ServerTableResponse, Skeleton, Slider, type SliderProps, type SortDir, StatCard, type StatCardProps, type StatTrend, StatsWidget, type StatsWidgetProps, type Step, type StepStatus, Stepper, type StepperProps, type TabItem, type TabSize, type TabVariant, Table, TableOfContents, type TableProps, TableWidget, type TableWidgetProps, Tabs, type TabsProps, TagInput, type TagInputProps, Textarea, type TextareaProps, type ThemeColors, ThemeProvider, type ThemeSettings, Timeline, type TimelineItem, type TimelineProps, type TimelineVariant, type ToastItem, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, type TocItem, TocProvider, ToggleSwitch, type ToggleSwitchProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, type TreeNode, TreeView, type TreeViewProps, type TrendDir, type UseServerDataGridOptions, type UseServerDataGridReturn, type UseServerTableOptions, type UseServerTableReturn, Widget, type WidgetProps, Wizard, type WizardActionProps, type WizardLayout, type WizardProps, type WizardSize, type WizardStep, type WizardVariant, api, createStore, decryptLaravelPayload, decryptResponse, getLaravelSecretKey, parseLaravelEncryptedPayload, parseLaravelKey, useServerDataGrid, useServerTable, useTheme, useToast, useToc };

package/dist/index.global.js

@@ -53730,7 +53730,11 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     Wizard: () => Wizard,
     api: () => api,
     createStore: () => createStore2,
-    useServerBulletin: () => useServerBulletin,
+    decryptLaravelPayload: () => decryptLaravelPayload,
+    decryptResponse: () => decryptResponse,
+    getLaravelSecretKey: () => getLaravelSecretKey,
+    parseLaravelEncryptedPayload: () => parseLaravelEncryptedPayload,
+    parseLaravelKey: () => parseLaravelKey,
     useServerDataGrid: () => useServerDataGrid,
     useServerTable: () => useServerTable,
     useTheme: () => useTheme,
@@ -64733,66 +64737,6 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
   // src/components/ui/bulletin-board.tsx
   var React8 = __toESM(require_react(), 1);
   var import_react_dom = __toESM(require_react_dom(), 1);
-
-  // src/components/tools/decryptPayload.ts
-  var import_crypto_js = __toESM(require_crypto_js(), 1);
-  function getLaravelSecretKey() {
-    const viteKey = (() => {
-      try {
-        return new Function("return import.meta.env")();
-      } catch {
-        return void 0;
-      }
-    })()?.VITE_LARAVEL_KEY;
-    const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
-    const windowKey = globalThis?.__LARAVEL_KEY__;
-    const key = viteKey || legacyKey || windowKey;
-    if (!key) {
-      throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
-    }
-    return key;
-  }
-  function parseLaravelKey(secretKey) {
-    if (secretKey.startsWith("base64:")) {
-      return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
-    }
-    return import_crypto_js.default.enc.Utf8.parse(secretKey);
-  }
-  function parseLaravelEncryptedPayload(payload) {
-    let jsonStr = payload;
-    try {
-      jsonStr = atob(payload);
-    } catch {
-    }
-    return JSON.parse(jsonStr);
-  }
-  function decryptLaravelPayload(payload, secretKey) {
-    const resolvedKey = secretKey ?? getLaravelSecretKey();
-    const parsed = parseLaravelEncryptedPayload(payload);
-    if (parsed.tag) {
-      throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
-    }
-    const key = parseLaravelKey(resolvedKey);
-    const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
-    if (expectedMac !== parsed.mac) {
-      throw new Error("Invalid payload MAC (wrong key or tampered payload).");
-    }
-    const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
-    const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
-    const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
-    const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
-      iv,
-      mode: import_crypto_js.default.mode.CBC,
-      padding: import_crypto_js.default.pad.Pkcs7
-    });
-    const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
-    if (!plaintext) {
-      throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
-    }
-    return JSON.parse(plaintext);
-  }
-
-  // src/components/ui/bulletin-board.tsx
   var import_jsx_runtime10 = __toESM(require_jsx_runtime(), 1);
   var PRIORITY_CONFIG = {
     urgent: { label: "Urgent", icon: /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(CircleAlert, { className: "h-3 w-3" }), badge: "error" },
@@ -64822,82 +64766,13 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     }
     return null;
   }
-  function useServerBulletin({
-    url: url2,
-    params,
-    encrypt,
-    key,
-    decryptPayloadLog,
-    transform
-  }) {
-    const [items, setItems] = React8.useState([]);
-    const [currentPage, setCurrentPage] = React8.useState(1);
-    const [pagination, setPagination] = React8.useState(null);
-    const [loading, setLoading] = React8.useState(false);
-    const [error, setError] = React8.useState(null);
-    const [tick, setTick] = React8.useState(0);
-    React8.useEffect(() => {
-      let cancelled = false;
-      setLoading(true);
-      setError(null);
-      axios_default.get(url2, { params: { ...params, page: currentPage } }).then(({ data: res }) => {
-        if (cancelled) return;
-        let payload;
-        try {
-          payload = encrypt ? decryptLaravelPayload(res, key) : res;
-        } catch (decryptErr) {
-          console.error("[useServerBulletin] decryption failed:", decryptErr?.message ?? decryptErr);
-          if (!cancelled) setError(decryptErr?.message ?? "Decryption failed");
-          return;
-        }
-        if (encrypt && decryptPayloadLog) console.log("[useServerBulletin] decrypted:", payload);
-        const rows = Array.isArray(payload) ? payload : payload.data ?? [];
-        setItems(transform ? rows.map(transform) : rows);
-        if (!Array.isArray(payload)) {
-          const rawTotal = payload.total;
-          const rawPerPage = payload.per_page;
-          const rawLastPage = payload.last_page;
-          const lastPage = rawLastPage ?? Math.ceil(rawTotal / rawPerPage);
-          const pg = payload.pagination ?? {
-            first_page_url: payload.first_page_url ?? `${url2}?page=1`,
-            last_page_url: payload.last_page_url ?? `${url2}?page=${lastPage}`,
-            last_page: lastPage,
-            next_page_url: payload.next_page_url !== void 0 ? payload.next_page_url : currentPage < lastPage ? `${url2}?page=${currentPage + 1}` : null,
-            prev_page_url: payload.prev_page_url !== void 0 ? payload.prev_page_url : currentPage > 1 ? `${url2}?page=${currentPage - 1}` : null,
-            per_page: rawPerPage,
-            total: rawTotal,
-            links: payload.links ?? []
-          };
-          setPagination(pg);
-        }
-      }).catch((err) => {
-        if (cancelled) return;
-        setError(err?.response?.data?.message ?? err.message ?? "Request failed");
-      }).finally(() => {
-        if (!cancelled) setLoading(false);
-      });
-      return () => {
-        cancelled = true;
-      };
-    }, [url2, currentPage, tick, JSON.stringify(params), encrypt, decryptPayloadLog]);
-    return {
-      items,
-      currentPage,
-      pagination,
-      serverPagination: pagination ? { pagination, currentPage, goToPage: (p) => setCurrentPage(p) } : null,
-      loading,
-      error,
-      goToPage: (p) => setCurrentPage(p),
-      reload: () => setTick((t) => t + 1)
-    };
-  }
-  function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+  function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
     const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
     return (0, import_react_dom.createPortal)(
       /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
         "div",
         {
-          className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+          className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
           style: { background: "rgba(0,0,0,0.55)" },
           onMouseDown: (e) => {
             if (e.target === e.currentTarget) onClose();
@@ -64910,7 +64785,8 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
                   " Pinned"
                 ] }),
                 priority && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-                item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category })
+                item.category && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Badge, { variant: "outline", size: "sm", children: item.category }),
+                headerAction
               ] }),
               /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-1 shrink-0", children: [
                 onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -65009,6 +64885,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
                 ] })
               ] }) }),
               /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "flex items-center gap-2", children: [
+                footerAction,
                 onEdit && /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
                   "button",
                   {
@@ -65403,6 +65280,9 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     deleteBaseUrl,
     deleteIdKey = "id",
     serverPagination,
+    footerAction,
+    headerPreviewAction,
+    footerPreviewAction,
     className
   }) {
     const [previewItem, setPreviewItem] = React8.useState(null);
@@ -65487,6 +65367,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
         /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(Pin, { className: "h-8 w-8 opacity-20" }),
         emptyMessage
       ] }) : layout === "list" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+      footerAction && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("div", { children: footerAction }),
       serverPagination && (() => {
         const { pagination, currentPage: cp, goToPage } = serverPagination;
         const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -65563,7 +65444,9 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
             setDeleteItem(item);
           } : onDelete ? (item) => {
             onDelete(item);
-          } : void 0
+          } : void 0,
+          footerAction: footerPreviewAction ? footerPreviewAction(previewItem) : void 0,
+          headerAction: headerPreviewAction
         }
       ),
       editItem && editBaseUrl && editFields && /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
@@ -67033,6 +66916,64 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
   var React29 = __toESM(require_react(), 1);
   var import_react_dom3 = __toESM(require_react_dom(), 1);
 
+  // src/components/tools/decryptPayload.ts
+  var import_crypto_js = __toESM(require_crypto_js(), 1);
+  function getLaravelSecretKey() {
+    const viteKey = (() => {
+      try {
+        return new Function("return import.meta.env")();
+      } catch {
+        return void 0;
+      }
+    })()?.VITE_LARAVEL_KEY;
+    const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
+    const windowKey = globalThis?.__LARAVEL_KEY__;
+    const key = viteKey || legacyKey || windowKey;
+    if (!key) {
+      throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
+    }
+    return key;
+  }
+  function parseLaravelKey(secretKey) {
+    if (secretKey.startsWith("base64:")) {
+      return import_crypto_js.default.enc.Base64.parse(secretKey.slice("base64:".length));
+    }
+    return import_crypto_js.default.enc.Utf8.parse(secretKey);
+  }
+  function parseLaravelEncryptedPayload(payload) {
+    let jsonStr = payload;
+    try {
+      jsonStr = atob(payload);
+    } catch {
+    }
+    return JSON.parse(jsonStr);
+  }
+  function decryptLaravelPayload(payload, secretKey) {
+    const resolvedKey = secretKey ?? getLaravelSecretKey();
+    const parsed = parseLaravelEncryptedPayload(payload);
+    if (parsed.tag) {
+      throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
+    }
+    const key = parseLaravelKey(resolvedKey);
+    const expectedMac = import_crypto_js.default.HmacSHA256(parsed.iv + parsed.value, key).toString(import_crypto_js.default.enc.Hex);
+    if (expectedMac !== parsed.mac) {
+      throw new Error("Invalid payload MAC (wrong key or tampered payload).");
+    }
+    const iv = import_crypto_js.default.enc.Base64.parse(parsed.iv);
+    const ciphertext = import_crypto_js.default.enc.Base64.parse(parsed.value);
+    const cipherParams = import_crypto_js.default.lib.CipherParams.create({ ciphertext });
+    const decrypted = import_crypto_js.default.AES.decrypt(cipherParams, key, {
+      iv,
+      mode: import_crypto_js.default.mode.CBC,
+      padding: import_crypto_js.default.pad.Pkcs7
+    });
+    const plaintext = decrypted.toString(import_crypto_js.default.enc.Utf8);
+    if (!plaintext) {
+      throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
+    }
+    return JSON.parse(plaintext);
+  }
+
   // src/components/ui/pagination.tsx
   var import_jsx_runtime19 = __toESM(require_jsx_runtime(), 1);
   function range(start, end) {
@@ -69964,7 +69905,7 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
       /* @__PURE__ */ (0, import_jsx_runtime32.jsx)(
         "div",
         {
-          className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+          className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
           style: { background: "rgba(0,0,0,0.5)" },
           onMouseDown: (e) => {
             if (e.target === e.currentTarget) onClose();
@@ -77626,6 +77567,12 @@ ${n2.shaderPreludeCode.vertexSource}`, define: n2.shaderDefine }, defaultProject
     };
     return { store, getStore };
   }
+
+  // src/core/decryption/decode.ts
+  function decryptResponse(response, key) {
+    const payload = typeof response === "string" ? response : response.data;
+    return decryptLaravelPayload(payload, key);
+  }
   return __toCommonJS(index_exports);
 })();
 /*! Bundled license information:

package/dist/index.js

@@ -1438,66 +1438,6 @@ import * as React8 from "react";
 import { createPortal as createPortal2 } from "react-dom";
 import axios2 from "axios";
 import { Search, Pin, Tag, MoreHorizontal as MoreHorizontal2, AlertCircle, AlertTriangle, Info, X, ChevronLeft as ChevronLeft2, ChevronRight as ChevronRight3, Pencil, Trash, Loader2 } from "lucide-react";
-
-// src/components/tools/decryptPayload.ts
-import CryptoJS from "crypto-js";
-function getLaravelSecretKey() {
-  const viteKey = (() => {
-    try {
-      return new Function("return import.meta.env")();
-    } catch {
-      return void 0;
-    }
-  })()?.VITE_LARAVEL_KEY;
-  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
-  const windowKey = globalThis?.__LARAVEL_KEY__;
-  const key = viteKey || legacyKey || windowKey;
-  if (!key) {
-    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
-  }
-  return key;
-}
-function parseLaravelKey(secretKey) {
-  if (secretKey.startsWith("base64:")) {
-    return CryptoJS.enc.Base64.parse(secretKey.slice("base64:".length));
-  }
-  return CryptoJS.enc.Utf8.parse(secretKey);
-}
-function parseLaravelEncryptedPayload(payload) {
-  let jsonStr = payload;
-  try {
-    jsonStr = atob(payload);
-  } catch {
-  }
-  return JSON.parse(jsonStr);
-}
-function decryptLaravelPayload(payload, secretKey) {
-  const resolvedKey = secretKey ?? getLaravelSecretKey();
-  const parsed = parseLaravelEncryptedPayload(payload);
-  if (parsed.tag) {
-    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
-  }
-  const key = parseLaravelKey(resolvedKey);
-  const expectedMac = CryptoJS.HmacSHA256(parsed.iv + parsed.value, key).toString(CryptoJS.enc.Hex);
-  if (expectedMac !== parsed.mac) {
-    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
-  }
-  const iv = CryptoJS.enc.Base64.parse(parsed.iv);
-  const ciphertext = CryptoJS.enc.Base64.parse(parsed.value);
-  const cipherParams = CryptoJS.lib.CipherParams.create({ ciphertext });
-  const decrypted = CryptoJS.AES.decrypt(cipherParams, key, {
-    iv,
-    mode: CryptoJS.mode.CBC,
-    padding: CryptoJS.pad.Pkcs7
-  });
-  const plaintext = decrypted.toString(CryptoJS.enc.Utf8);
-  if (!plaintext) {
-    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
-  }
-  return JSON.parse(plaintext);
-}
-
-// src/components/ui/bulletin-board.tsx
 import { Fragment as Fragment5, jsx as jsx10, jsxs as jsxs9 } from "react/jsx-runtime";
 var PRIORITY_CONFIG = {
   urgent: { label: "Urgent", icon: /* @__PURE__ */ jsx10(AlertCircle, { className: "h-3 w-3" }), badge: "error" },
@@ -1527,82 +1467,13 @@ function AuthorAvatar({ item }) {
   }
   return null;
 }
-function useServerBulletin({
-  url,
-  params,
-  encrypt,
-  key,
-  decryptPayloadLog,
-  transform
-}) {
-  const [items, setItems] = React8.useState([]);
-  const [currentPage, setCurrentPage] = React8.useState(1);
-  const [pagination, setPagination] = React8.useState(null);
-  const [loading, setLoading] = React8.useState(false);
-  const [error, setError] = React8.useState(null);
-  const [tick, setTick] = React8.useState(0);
-  React8.useEffect(() => {
-    let cancelled = false;
-    setLoading(true);
-    setError(null);
-    axios2.get(url, { params: { ...params, page: currentPage } }).then(({ data: res }) => {
-      if (cancelled) return;
-      let payload;
-      try {
-        payload = encrypt ? decryptLaravelPayload(res, key) : res;
-      } catch (decryptErr) {
-        console.error("[useServerBulletin] decryption failed:", decryptErr?.message ?? decryptErr);
-        if (!cancelled) setError(decryptErr?.message ?? "Decryption failed");
-        return;
-      }
-      if (encrypt && decryptPayloadLog) console.log("[useServerBulletin] decrypted:", payload);
-      const rows = Array.isArray(payload) ? payload : payload.data ?? [];
-      setItems(transform ? rows.map(transform) : rows);
-      if (!Array.isArray(payload)) {
-        const rawTotal = payload.total;
-        const rawPerPage = payload.per_page;
-        const rawLastPage = payload.last_page;
-        const lastPage = rawLastPage ?? Math.ceil(rawTotal / rawPerPage);
-        const pg = payload.pagination ?? {
-          first_page_url: payload.first_page_url ?? `${url}?page=1`,
-          last_page_url: payload.last_page_url ?? `${url}?page=${lastPage}`,
-          last_page: lastPage,
-          next_page_url: payload.next_page_url !== void 0 ? payload.next_page_url : currentPage < lastPage ? `${url}?page=${currentPage + 1}` : null,
-          prev_page_url: payload.prev_page_url !== void 0 ? payload.prev_page_url : currentPage > 1 ? `${url}?page=${currentPage - 1}` : null,
-          per_page: rawPerPage,
-          total: rawTotal,
-          links: payload.links ?? []
-        };
-        setPagination(pg);
-      }
-    }).catch((err) => {
-      if (cancelled) return;
-      setError(err?.response?.data?.message ?? err.message ?? "Request failed");
-    }).finally(() => {
-      if (!cancelled) setLoading(false);
-    });
-    return () => {
-      cancelled = true;
-    };
-  }, [url, currentPage, tick, JSON.stringify(params), encrypt, decryptPayloadLog]);
-  return {
-    items,
-    currentPage,
-    pagination,
-    serverPagination: pagination ? { pagination, currentPage, goToPage: (p) => setCurrentPage(p) } : null,
-    loading,
-    error,
-    goToPage: (p) => setCurrentPage(p),
-    reload: () => setTick((t) => t + 1)
-  };
-}
-function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions }) {
+function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customActions, headerAction, footerAction }) {
   const priority = item.priority ? PRIORITY_CONFIG[item.priority] : null;
   return createPortal2(
     /* @__PURE__ */ jsx10(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.55)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -1615,7 +1486,8 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
                 " Pinned"
               ] }),
               priority && /* @__PURE__ */ jsx10(Badge, { variant: priority.badge, size: "sm", icon: priority.icon ?? void 0, children: priority.label }),
-              item.category && /* @__PURE__ */ jsx10(Badge, { variant: "outline", size: "sm", children: item.category })
+              item.category && /* @__PURE__ */ jsx10(Badge, { variant: "outline", size: "sm", children: item.category }),
+              headerAction
             ] }),
             /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-1 shrink-0", children: [
               onEdit && /* @__PURE__ */ jsx10(
@@ -1714,6 +1586,7 @@ function BulletinPreview({ item, onClose, onEdit, onDelete, onView, customAction
               ] })
             ] }) }),
             /* @__PURE__ */ jsxs9("div", { className: "flex items-center gap-2", children: [
+              footerAction,
               onEdit && /* @__PURE__ */ jsxs9(
                 "button",
                 {
@@ -2108,6 +1981,9 @@ function BulletinBoard({
   deleteBaseUrl,
   deleteIdKey = "id",
   serverPagination,
+  footerAction,
+  headerPreviewAction,
+  footerPreviewAction,
   className
 }) {
   const [previewItem, setPreviewItem] = React8.useState(null);
@@ -2192,6 +2068,7 @@ function BulletinBoard({
       /* @__PURE__ */ jsx10(Pin, { className: "h-8 w-8 opacity-20" }),
       emptyMessage
     ] }) : layout === "list" ? /* @__PURE__ */ jsx10("div", { className: "flex flex-col gap-3", children: filtered.map((item) => /* @__PURE__ */ jsx10(BulletinCard, { item, variant, layout: "list", onClick: handleCardClick }, item.id)) }) : layout === "masonry" ? /* @__PURE__ */ jsx10("div", { className: cn("gap-4", COLS_CLASS[columns]), style: { display: "grid", gridTemplateRows: "masonry" }, children: filtered.map((item) => /* @__PURE__ */ jsx10(BulletinCard, { item, variant, layout: "masonry", onClick: handleCardClick }, item.id)) }) : /* @__PURE__ */ jsx10("div", { className: cn("grid gap-4", COLS_CLASS[columns]), children: filtered.map((item) => /* @__PURE__ */ jsx10(BulletinCard, { item, variant, layout: "grid", onClick: handleCardClick }, item.id)) }),
+    footerAction && /* @__PURE__ */ jsx10("div", { children: footerAction }),
     serverPagination && (() => {
       const { pagination, currentPage: cp, goToPage } = serverPagination;
       const totalPages = pagination.last_page ?? Math.ceil(pagination.total / pagination.per_page);
@@ -2268,7 +2145,9 @@ function BulletinBoard({
           setDeleteItem(item);
         } : onDelete ? (item) => {
           onDelete(item);
-        } : void 0
+        } : void 0,
+        footerAction: footerPreviewAction ? footerPreviewAction(previewItem) : void 0,
+        headerAction: headerPreviewAction
       }
     ),
     editItem && editBaseUrl && editFields && /* @__PURE__ */ jsx10(
@@ -3742,6 +3621,66 @@ function MetricRow({ items, divided = true, className }) {
 // src/components/ui/data-grid.tsx
 import * as React29 from "react";
 import { createPortal as createPortal4 } from "react-dom";
+
+// src/components/tools/decryptPayload.ts
+import CryptoJS from "crypto-js";
+function getLaravelSecretKey() {
+  const viteKey = (() => {
+    try {
+      return new Function("return import.meta.env")();
+    } catch {
+      return void 0;
+    }
+  })()?.VITE_LARAVEL_KEY;
+  const legacyKey = globalThis?.process?.env?.REACT_APP_LARAVEL_KEY;
+  const windowKey = globalThis?.__LARAVEL_KEY__;
+  const key = viteKey || legacyKey || windowKey;
+  if (!key) {
+    throw new Error("Missing Laravel decryption key. Set VITE_LARAVEL_KEY in your .env or inject window.__LARAVEL_KEY__ via Blade.");
+  }
+  return key;
+}
+function parseLaravelKey(secretKey) {
+  if (secretKey.startsWith("base64:")) {
+    return CryptoJS.enc.Base64.parse(secretKey.slice("base64:".length));
+  }
+  return CryptoJS.enc.Utf8.parse(secretKey);
+}
+function parseLaravelEncryptedPayload(payload) {
+  let jsonStr = payload;
+  try {
+    jsonStr = atob(payload);
+  } catch {
+  }
+  return JSON.parse(jsonStr);
+}
+function decryptLaravelPayload(payload, secretKey) {
+  const resolvedKey = secretKey ?? getLaravelSecretKey();
+  const parsed = parseLaravelEncryptedPayload(payload);
+  if (parsed.tag) {
+    throw new Error("Unsupported Laravel cipher (AEAD tag present). Expected AES-*-CBC payload.");
+  }
+  const key = parseLaravelKey(resolvedKey);
+  const expectedMac = CryptoJS.HmacSHA256(parsed.iv + parsed.value, key).toString(CryptoJS.enc.Hex);
+  if (expectedMac !== parsed.mac) {
+    throw new Error("Invalid payload MAC (wrong key or tampered payload).");
+  }
+  const iv = CryptoJS.enc.Base64.parse(parsed.iv);
+  const ciphertext = CryptoJS.enc.Base64.parse(parsed.value);
+  const cipherParams = CryptoJS.lib.CipherParams.create({ ciphertext });
+  const decrypted = CryptoJS.AES.decrypt(cipherParams, key, {
+    iv,
+    mode: CryptoJS.mode.CBC,
+    padding: CryptoJS.pad.Pkcs7
+  });
+  const plaintext = decrypted.toString(CryptoJS.enc.Utf8);
+  if (!plaintext) {
+    throw new Error("Decryption produced empty plaintext (wrong key/cipher).");
+  }
+  return JSON.parse(plaintext);
+}
+
+// src/components/ui/data-grid.tsx
 import axios4 from "axios";
 import { ChevronUp as ChevronUp2, ChevronDown as ChevronDown5, ChevronsUpDown as ChevronsUpDown2, ChevronLeft as ChevronLeft7, ChevronRight as ChevronRight9, Search as Search6, Settings2, Check as Check5, Eye as Eye3, Pencil as Pencil3, Trash as Trash4, Loader2 as Loader23, X as X10 } from "lucide-react";
 
@@ -6685,7 +6624,7 @@ function ModalShell({ title, onClose, children, footer, width = "lg" }) {
     /* @__PURE__ */ jsx32(
       "div",
       {
-        className: "fixed inset-0 z-50 flex items-center justify-center p-4",
+        className: "fixed inset-0 z-50 flex glass items-center justify-center p-4",
         style: { background: "rgba(0,0,0,0.5)" },
         onMouseDown: (e) => {
           if (e.target === e.currentTarget) onClose();
@@ -13696,6 +13635,12 @@ function createStore(initialValue, sessionName, expireInterval) {
   };
   return { store, getStore };
 }
+
+// src/core/decryption/decode.ts
+function decryptResponse(response, key) {
+  const payload = typeof response === "string" ? response : response.data;
+  return decryptLaravelPayload(payload, key);
+}
 export {
   Accordion,
   Authentication,
@@ -13795,7 +13740,11 @@ export {
   Wizard,
   api,
   createStore,
-  useServerBulletin,
+  decryptLaravelPayload,
+  decryptResponse,
+  getLaravelSecretKey,
+  parseLaravelEncryptedPayload,
+  parseLaravelKey,
   useServerDataGrid,
   useServerTable,
   useTheme,

package/package.json

@@ -4,7 +4,7 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "3.5.21",
+  "version": "3.6.0",
   "description": "Reusable React UI components",
   "license": "MIT",
   "main": "dist/index.js",