@nivaro/react 0.1.225 → 0.1.227

package/dist/index.d.ts

@@ -54,6 +54,10 @@ export declare const ACTIVE_USER_OPTION_FILTER: {
     })[];
 };
 
+/** A status whose expiry has passed reads as no status (the server does the
+ *  same on /presence/online — the row is only cleared lazily). */
+export declare function activeCustomStatus(raw: unknown): CustomStatus | null;
+
 declare interface ActiveFilter {
     id: string;
     path: string[];
@@ -854,6 +858,36 @@ export declare function CustomActionButtons({ collection, itemId, draft }: {
     draft: Record<string, unknown>;
 }): JSX.Element | null;
 
+/** `nivaro_users.preferences.custom_status` — free text + emoji beside the
+ *  presence state, self-clearing at `expires_at`. */
+export declare type CustomStatus = {
+    text: string;
+    emoji: string | null;
+    expires_at?: string | null;
+};
+
+/**
+ * The ONE editor for a user's own custom status — the chat panel's Online tab
+ * and the profile header both render it, so the two can never disagree.
+ * Saves through PATCH /users/me/preferences and invalidates the presence
+ * roster plus any query keys the host names (`invalidate`).
+ */
+export declare function CustomStatusEditor({ status, invalidate, theme, showExpiry, className }: {
+    status: CustomStatus | null;
+    /** Extra query-key prefixes to invalidate after a save (the host's own
+     *  "me" query). ['presence-online'] is always included. */
+    invalidate?: ReadonlyArray<readonly unknown[]>;
+    /** Class slots (chat theme) — defaults use the brand tokens. */
+    theme?: {
+        accentSoft?: string;
+        input?: string;
+        action?: string;
+    };
+    /** Profile variant: show "until 3:00 PM" beside the status. */
+    showExpiry?: boolean;
+    className?: string;
+}): JSX.Element;
+
 export declare function DataTable<T = Record<string, unknown>>({ columns, rows, rowKey, total, page, limit, isLoading, isError, errorMessage, sort, onSortChange, onPageChange, onRowClick, onRowContextMenu, searchValue, onSearchChange, searchPlaceholder, filterDefs, filterValues, onFilterChange, toolbarRight, emptyMessage, minBodyHeight, fillHeight, hideFilterRow, nowrapCells, density, pinFirstColumn, columnPins, onColumnPinChange, columnFilterRow, hScrollProxy, selectedIds, onSelectionChange, rowClassName, enterKey, rowGroups, collapsedGroups, onToggleGroup }: DataTableProps<T>): React_2.JSX.Element;
 
 export declare interface DataTableProps<T = Record<string, unknown>> {
@@ -1365,6 +1399,8 @@ export declare function formatNumber(n: number | null | undefined): string;
 
 export declare function formatRelative(date: string | Date): string;
 
+export declare function formatStatusExpiry(expiresAt: string | null | undefined): string | null;
+
 export declare function formatValue(raw: string, cfg: ColumnFormatConfig): string;
 
 export declare type FormDirtyState = {