@ezychat/web 0.0.0-stage → 0.1.38

package/dist-lib/types/i18n/use-change-locale.d.ts

@@ -0,0 +1,9 @@
+import type { Locale } from '@ezychat/shared';
+/**
+ * Current language plus a setter that applies it here and, once it has loaded, saves it to the
+ * account when signed in.
+ */
+export declare function useChangeLocale(): {
+    locale: "en" | "ms" | "zh-CN";
+    changeLocale: (next: Locale) => void;
+};

package/dist-lib/types/inbox/ChatAvatar.d.ts

@@ -0,0 +1,13 @@
+declare const SIZES: {
+    readonly sm: "size-8 text-xs";
+    readonly md: "size-10 text-sm";
+    readonly lg: "size-12 text-base";
+};
+export declare function ChatAvatar({ name, src, seed, size, className, }: {
+    name: string;
+    src?: string | null;
+    seed?: string;
+    size?: keyof typeof SIZES;
+    className?: string;
+}): import("react").JSX.Element;
+export {};

package/dist-lib/types/inbox/ChatFilters.d.ts

@@ -0,0 +1,6 @@
+import { type ChatFilters as Filters } from '../api/queries';
+export interface ChatFiltersProps {
+    value: Filters;
+    onChange(next: Filters): void;
+}
+export declare function ChatFilters({ value, onChange }: ChatFiltersProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ChatList.d.ts

@@ -0,0 +1,9 @@
+import { type ChatFilters } from '../api/queries';
+import type { Directory } from './useDirectory';
+export interface ChatListProps {
+    filters: ChatFilters;
+    activeJid: string | null;
+    directory: Directory;
+    onResetFilters?(): void;
+}
+export declare function ChatList({ filters, activeJid, directory, onResetFilters }: ChatListProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ChatListItem.d.ts

@@ -0,0 +1,13 @@
+import type { Chat } from '@ezychat/shared';
+export interface ChatListItemProps {
+    chat: Chat;
+    active: boolean;
+    /** Assignee display name ("You" for the current user), or null when unassigned. */
+    assigneeName: string | null;
+    /** The current user owns this chat: the chip gets the accent outline. */
+    assignedToMe?: boolean;
+}
+export declare function GroupIcon({ className }: {
+    className?: string;
+}): import("react").JSX.Element;
+export declare function ChatListItem({ chat, active, assigneeName, assignedToMe, }: ChatListItemProps): import("react").JSX.Element;

package/dist-lib/types/inbox/Composer.d.ts

@@ -0,0 +1,30 @@
+import type React from 'react';
+import type { QuickReply } from '@ezychat/shared';
+export interface ComposerProps {
+    quickReplies: QuickReply[];
+    onSend(text: string): void;
+    /** Attach button: file + caption (current text, if any). */
+    onAttach(file: File, caption?: string): void;
+    /**
+     * Mic button (shown while the box is empty): a recorded Ogg/Opus voice note with the clientId it
+     * keeps across retries. Resolve once it is uploaded; reject to keep it in Review.
+     */
+    onVoiceNote?(file: File, clientId: string): void | Promise<void>;
+    /** Called while typing; throttled to once per 2s. */
+    onTyping?(): void;
+    /**
+     * Called before every send/attach. Resolve `false` to cancel (the text is kept).
+     * Used for the "Assigned to X — reply anyway?" confirmation.
+     */
+    confirmSend?(): boolean | Promise<boolean>;
+    disabled?: boolean;
+    placeholder?: string;
+    /** The message being replied to: shown in a bar above the box until sent or cancelled. */
+    replyTo?: {
+        id: string;
+        author: string;
+        preview: string;
+    } | null;
+    onCancelReply?(): void;
+}
+export declare function Composer({ quickReplies, onSend, onAttach, onVoiceNote, onTyping, confirmSend, disabled, placeholder, replyTo, onCancelReply, }: ComposerProps): React.JSX.Element;

package/dist-lib/types/inbox/Conversation.d.ts

@@ -0,0 +1,7 @@
+import type { Directory } from './useDirectory';
+export interface ConversationProps {
+    jid: string;
+    directory: Directory;
+    onBack(): void;
+}
+export declare function Conversation({ jid, directory, onBack }: ConversationProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ConversationHeader.d.ts

@@ -0,0 +1,25 @@
+import type { Chat } from '@ezychat/shared';
+import type { Directory } from './useDirectory';
+export interface ConversationHeaderProps {
+    chat: Chat;
+    directory: Directory;
+    onBack(): void;
+    onAssign(userId: number | null): void;
+    onToggleStatus(): void;
+    notesOpen: boolean;
+    notesCount: number;
+    onToggleNotes(): void;
+    /** Direct chats only: the Customer details button. */
+    showCustomer: boolean;
+    customerOpen: boolean;
+    onToggleCustomer(): void;
+    /**
+     * Clicking the chat's avatar and name opens its details, like WhatsApp: Group info for a group,
+     * Customer details for a direct chat.
+     */
+    onOpenInfo?(): void;
+    /** Group chats: WhatsApp's member count, shown under the name once known. */
+    memberCount?: number | null;
+    busy?: boolean;
+}
+export declare function ConversationHeader({ chat, directory, onBack, onAssign, onToggleStatus, notesOpen, notesCount, onToggleNotes, showCustomer, customerOpen, onToggleCustomer, onOpenInfo, memberCount, busy, }: ConversationHeaderProps): import("react").JSX.Element;

package/dist-lib/types/inbox/CustomerPanel.d.ts

@@ -0,0 +1,32 @@
+import type React from 'react';
+import { type CustomerProfile, type CustomerProfileResponse } from '@ezychat/shared';
+import type { Directory } from './useDirectory';
+export interface CustomerPanelProps {
+    jid: string;
+    open: boolean;
+    directory: Directory;
+    onClose(): void;
+    /**
+     * Filled by the panel while editing: run an action (close, switch panels) now, or after the
+     * teammate confirms discarding unsaved changes. The conversation header buttons use it.
+     */
+    guardRef?: React.RefObject<((next: () => void) => void) | null>;
+}
+type WhatsappFactsData = NonNullable<CustomerProfileResponse['whatsapp']>;
+/** Read-only view of a customer profile (also used in the group sender popover). */
+export declare function CustomerDetails({ profile, whatsappName, whatsappPhone, whatsapp, directory, }: {
+    profile: CustomerProfile;
+    whatsappName: string | null;
+    /** Digits WhatsApp gave us (no `+`), when known. */
+    whatsappPhone?: string | null;
+    /** Read-only WhatsApp facts; replaces the one-line summary when the server sends them. */
+    whatsapp?: WhatsappFactsData;
+    /** For "Updated by <teammate>"; that line is left out without it. */
+    directory?: Directory;
+}): React.JSX.Element;
+/**
+ * Customer profile of a direct chat, editable by every teammate. Side panel on >= lg,
+ * full-height Sheet below (same layout as Notes).
+ */
+export declare function CustomerPanel({ open, onClose, guardRef: outerGuard, ...rest }: CustomerPanelProps): React.JSX.Element | null;
+export {};

package/dist-lib/types/inbox/EmojiPicker.d.ts

@@ -0,0 +1,6 @@
+/** Small, local-only emoji picker. Search never leaves the device. */
+export declare function EmojiPicker({ disabled, onOpen, onPick, }: {
+    disabled?: boolean;
+    onOpen(): void;
+    onPick(emoji: string): void;
+}): import("react").JSX.Element;

package/dist-lib/types/inbox/EventItem.d.ts

@@ -0,0 +1,14 @@
+import { type ChatEvent, type Note } from '@ezychat/shared';
+import type { Directory } from './useDirectory';
+/** Localized sentence for a chat event, in the active UI language. */
+export declare function describeEvent(e: ChatEvent, dir: Directory): string;
+/** Centered chip for assignment / status events. */
+export declare function EventItem({ event, directory }: {
+    event: ChatEvent;
+    directory: Directory;
+}): import("react").JSX.Element | null;
+/** Amber internal-note card shown inline in the timeline (never looks like a bubble). */
+export declare function NoteItem({ note, directory }: {
+    note: Note;
+    directory: Directory;
+}): import("react").JSX.Element;

package/dist-lib/types/inbox/GettingStartedCard.d.ts

@@ -0,0 +1,10 @@
+/** Per-browser memory of the × on the card. Storage can be blocked, so every access is guarded. */
+export declare const GETTING_STARTED_HIDDEN_KEY = "ezychat.getting-started-hidden";
+/**
+ * A small "Getting started" card on the empty inbox, for admins only. Lists what is left
+ * (AI assistant, teammates, phone access), links each to its admin page and hides finished items;
+ * the whole card disappears once everything is done or the admin dismisses it.
+ */
+export declare function GettingStartedCard({ className }: {
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist-lib/types/inbox/GroupPanel.d.ts

@@ -0,0 +1,19 @@
+import type React from 'react';
+import { useTranslation } from 'react-i18next';
+import type { GroupMember } from '@ezychat/shared';
+/** Rows rendered at a time; large groups show more on request instead of rendering all at once. */
+export declare const MEMBER_PAGE = 100;
+export interface GroupPanelProps {
+    jid: string;
+    open: boolean;
+    onClose(): void;
+}
+type T = ReturnType<typeof useTranslation<'inbox'>>['t'];
+/** What the team can call a member: our name for them, else their number, else their WhatsApp ID. */
+export declare function memberLabel(m: GroupMember, t: T): string;
+/**
+ * Group info: the members of a WhatsApp group (read from WhatsApp, view-only), with search, an
+ * admins filter and per-member details. Side panel on >= lg, full-height Sheet below.
+ */
+export declare function GroupPanel({ jid, open, onClose }: GroupPanelProps): React.JSX.Element | null;
+export {};

package/dist-lib/types/inbox/InboxPage.d.ts

@@ -0,0 +1,2 @@
+export declare function InboxPage(): import("react").JSX.Element;
+export default InboxPage;

package/dist-lib/types/inbox/MediaView.d.ts

@@ -0,0 +1,8 @@
+import type { Message } from '@ezychat/shared';
+export interface MediaViewProps {
+    message: Message;
+    /** Fired when an image/video finishes loading (lets the list keep its scroll anchored). */
+    onLoad?(): void;
+}
+/** Renders the media part of a message (image, sticker, video, audio, document). */
+export declare function MediaView({ message: m, onLoad }: MediaViewProps): import("react").JSX.Element;

package/dist-lib/types/inbox/MessageBubble.d.ts

@@ -0,0 +1,31 @@
+import type React from 'react';
+import type { TFunction } from 'i18next';
+import type { Message } from '@ezychat/shared';
+import type { Directory } from './useDirectory';
+export interface MessageBubbleProps {
+    message: Message;
+    /** Show the sender name above inbound bubbles (group chats). */
+    showSender: boolean;
+    /** Outbound label: agent display name, or "via phone" when sent from the phone. */
+    outboundLabel: string | null;
+    quoted: Message | null;
+    onRetry?(m: Message): void;
+    retrying?: boolean;
+    /** Start a reply that quotes this message (hover button, swipe right or long-press on touch). */
+    onReply?(m: Message): void;
+    onMediaLoad?(): void;
+    /** Team directory, for "Updated by" in a group sender's profile popover. */
+    directory?: Directory;
+    /** Direct chats: the customer's name as the header shows it (used in quotes). */
+    contactName?: string;
+}
+/**
+ * Who wrote a quoted message. In a direct chat the customer is named like the chat header
+ * (`contactName`), not by their WhatsApp profile name; groups name each sender.
+ */
+export declare function quotedAuthor(q: Message, t: TFunction<'inbox'>, contactName?: string): string;
+export declare function quotedPreview(q: Message, t: TFunction<'inbox'>): string;
+export declare function StatusTicks({ status }: {
+    status: Message['status'];
+}): React.JSX.Element;
+export declare function MessageBubble({ message: m, showSender, outboundLabel, quoted, onRetry, retrying, onMediaLoad, directory, onReply, contactName, }: MessageBubbleProps): React.JSX.Element;

package/dist-lib/types/inbox/MessageList.d.ts

@@ -0,0 +1,21 @@
+import type React from 'react';
+import type { Message } from '@ezychat/shared';
+import type { TimelineItem } from './timeline';
+import type { Directory } from './useDirectory';
+export interface MessageListProps {
+    items: TimelineItem[];
+    messagesById: Map<string, Message>;
+    isGroup: boolean;
+    directory: Directory;
+    loading: boolean;
+    hasOlder: boolean;
+    loadingOlder: boolean;
+    onLoadOlder(): void;
+    onRetry(m: Message): void;
+    retryingId: string | null;
+    onReply?(m: Message): void;
+    /** Direct chats: the customer's display name, for quotes. */
+    contactName?: string;
+    footer?: React.ReactNode;
+}
+export declare function MessageList({ items, messagesById, isGroup, directory, loading, hasOlder, loadingOlder, onLoadOlder, onRetry, retryingId, onReply, contactName, footer, }: MessageListProps): React.JSX.Element;

package/dist-lib/types/inbox/NotesPanel.d.ts

@@ -0,0 +1,15 @@
+import type React from 'react';
+import type { Note } from '@ezychat/shared';
+import type { Directory } from './useDirectory';
+export interface NotesPanelProps {
+    jid: string;
+    open: boolean;
+    notes: Note[];
+    loading: boolean;
+    directory: Directory;
+    onClose(): void;
+}
+/**
+ * Internal notes (never sent to the customer). Side panel on >= lg, full-height Sheet below.
+ */
+export declare function NotesPanel({ open, onClose, ...rest }: NotesPanelProps): React.JSX.Element | null;

package/dist-lib/types/inbox/PanelHeader.d.ts

@@ -0,0 +1,13 @@
+import type React from 'react';
+/**
+ * Header of the conversation side panels (Customer, Notes): icon + title, optional action, Close,
+ * and the one-line description inside the same bordered block. Panels use `px-4` throughout.
+ */
+export declare function PanelHeader({ icon, title, description, action, closeLabel, onClose, }: {
+    icon: React.ReactNode;
+    title: React.ReactNode;
+    description: React.ReactNode;
+    action?: React.ReactNode;
+    closeLabel: string;
+    onClose(): void;
+}): React.JSX.Element;

package/dist-lib/types/inbox/ProfileImageContext.d.ts

@@ -0,0 +1,5 @@
+/** One connection generation shared by every photo, including list and conversation copies. */
+export declare const ProfileImageContext: import("react").Context<{
+    ready: boolean;
+    revision: number;
+}>;

package/dist-lib/types/inbox/QuickReplyPicker.d.ts

@@ -0,0 +1,18 @@
+import type { QuickReply } from '@ezychat/shared';
+/** Quick replies whose shortcut starts with `query` (case-insensitive), sorted by shortcut. */
+export declare function filterQuickReplies(replies: QuickReply[], query: string): QuickReply[];
+export interface QuickReplyPickerProps {
+    replies: QuickReply[];
+    /** Text typed after the leading `/`. */
+    query: string;
+    /** Index into the filtered list. */
+    activeIndex: number;
+    onPick(reply: QuickReply): void;
+    onHover?(index: number): void;
+}
+/**
+ * `/shortcut` picker built on cmdk. Filtering and keyboard handling (↑/↓/Enter/Tab/Escape) live
+ * in the Composer, which keeps focus in the textarea and drives `activeIndex`; cmdk renders the
+ * listbox/option semantics and the highlighted row.
+ */
+export declare function QuickReplyPicker({ replies, query, activeIndex, onPick, onHover, }: QuickReplyPickerProps): import("react").JSX.Element;

package/dist-lib/types/inbox/ReconnectBanner.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shown while the realtime (Socket.IO) link to the server is down after having been up once,
+ * so agents know the inbox may be stale. Pure on `connected` (exported for tests).
+ */
+export declare function ReconnectBannerView({ connected }: {
+    connected: boolean;
+}): import("react").JSX.Element | null;
+export declare function ReconnectBanner(): import("react").JSX.Element;

package/dist-lib/types/inbox/TagInput.d.ts

@@ -0,0 +1,14 @@
+import type React from 'react';
+export interface TagInputProps {
+    value: string[];
+    onChange(tags: string[]): void;
+    /** Existing tags to offer; filtered by prefix and minus the chosen ones. */
+    suggestions?: readonly string[];
+    /** Called with the text being typed, e.g. to fetch suggestions for it. */
+    onQueryChange?(q: string): void;
+    id?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+}
+/** Free-text tags: Enter or comma adds, Backspace on an empty input removes the last one. */
+export declare function TagInput({ value, onChange, suggestions, onQueryChange, id, ...aria }: TagInputProps): React.JSX.Element;

package/dist-lib/types/inbox/TypingIndicator.d.ts

@@ -0,0 +1,6 @@
+import type { TypingEntry } from '../api/socket';
+/** "Alice is typing…" for other agents working on the same chat. */
+export declare function TypingIndicator({ entries, meId, }: {
+    entries: TypingEntry[];
+    meId: number | null;
+}): import("react").JSX.Element | null;

package/dist-lib/types/inbox/VoiceNote.d.ts

@@ -0,0 +1,36 @@
+import { type VoiceStartError } from '../lib/voice-recorder';
+/** `lost`: the recording could not be finished (the encoder failed), so there is nothing to send. */
+export type VoicePhase = 'idle' | 'starting' | 'recording' | 'review' | 'lost' | VoiceStartError;
+export declare const formatClock: (s: number) => string;
+interface Review {
+    /** One id per recording: every send attempt of it uses this clientId, so retries never duplicate. */
+    clientId: string;
+    blob: Blob;
+    url: string;
+    seconds: number;
+    bars: number[];
+}
+/**
+ * Record → (review) → send a voice note. `send` gets the Ogg/Opus file and resolves `true` once it
+ * accepted it; until then (a declined confirmation, a disabled composer) the recording is kept.
+ */
+export declare function useVoiceNote(send: (file: File, clientId: string) => boolean | Promise<boolean>): {
+    phase: VoicePhase;
+    seconds: number;
+    liveBars: number[];
+    review: Review | null;
+    sending: boolean;
+    sendFailed: boolean;
+    start: () => Promise<void>;
+    toReview: () => Promise<void>;
+    sendNow: () => Promise<void>;
+    sendReviewed: () => Promise<void>;
+    discard: () => void;
+    dismiss: () => void;
+};
+export type VoiceNoteState = ReturnType<typeof useVoiceNote>;
+/** The composer row while a voice note is being recorded, reviewed, or could not start. */
+export declare function VoiceNoteBar({ voice }: Readonly<{
+    voice: VoiceNoteState;
+}>): import("react").JSX.Element;
+export {};

package/dist-lib/types/inbox/WaBanner.d.ts

@@ -0,0 +1,9 @@
+import type { WaStatus } from '@ezychat/shared';
+type WaStateName = WaStatus['state'];
+/** States where outgoing messages are queued and will go out once reconnected. */
+export declare function waQueuesMessages(state: WaStateName | undefined): boolean;
+/** States where sending is pointless until an admin acts (composer disabled). */
+export declare function waSendingBlocked(state: WaStateName | undefined): boolean;
+/** Top-of-inbox banner shown whenever the WhatsApp connection isn't open. */
+export declare function WaBanner(): import("react").JSX.Element | null;
+export {};

package/dist-lib/types/inbox/chat-title.d.ts

@@ -0,0 +1,4 @@
+import type { TFunction } from 'i18next';
+import type { Chat } from '@ezychat/shared';
+/** Chat title: its name, else +phone, else a translated placeholder. Never WhatsApp ID digits. */
+export declare function chatTitle(chat: Pick<Chat, 'name' | 'phone' | 'type'>, t: TFunction<'inbox'>): string;

package/dist-lib/types/inbox/navigation-guard.d.ts

@@ -0,0 +1,17 @@
+import type React from 'react';
+import { type NavigateOptions } from 'react-router-dom';
+/** Runs `next` now, or after the teammate confirms leaving (e.g. discarding unsaved edits). */
+export type NavigationGuard = (next: () => void) => void;
+type GuardRef = React.RefObject<NavigationGuard | null>;
+/** Holds the guard of the open conversation for the whole inbox page. */
+export declare function NavigationGuardProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+/** The page's guard slot, or a private one outside a provider (tests, standalone use). */
+export declare function useNavigationGuardRef(): GuardRef;
+/**
+ * `onClick` for an in-app `<Link>`: a plain click goes through the guard first; modified clicks
+ * (new tab / window) are left to the browser.
+ */
+export declare function useGuardedLinkClick(to: string, options?: NavigateOptions): (e: React.MouseEvent<HTMLAnchorElement>) => void;
+export {};

package/dist-lib/types/inbox/timeline.d.ts

@@ -0,0 +1,26 @@
+import type { ChatEvent, Message, Note } from '@ezychat/shared';
+export type TimelineItem = {
+    kind: 'day';
+    key: string; /** Local midnight (epoch ms) of that day. */
+    date: number;
+} | {
+    kind: 'message';
+    key: string;
+    at: number;
+    message: Message;
+} | {
+    kind: 'event';
+    key: string;
+    at: number;
+    event: ChatEvent;
+} | {
+    kind: 'note';
+    key: string;
+    at: number;
+    note: Note;
+};
+/**
+ * Merge messages, chat events and notes into one ascending timeline, inserting a
+ * `{ kind: 'day' }` separator before the first item of every local calendar day.
+ */
+export declare function buildTimeline(messages: Message[], events: ChatEvent[], notes: Note[]): TimelineItem[];

package/dist-lib/types/inbox/useCanonicalChatRedirect.d.ts

@@ -0,0 +1,2 @@
+/** Old links and push notifications: follow the chat JID the server answered with. */
+export declare function useCanonicalChatRedirect(jid: string | null): void;

package/dist-lib/types/inbox/useDirectory.d.ts

@@ -0,0 +1,21 @@
+import type { User } from '@ezychat/shared';
+import { type DirectoryUser } from '../api/queries';
+export interface Directory {
+    me: User | null;
+    isAdmin: boolean;
+    byId: Map<number, DirectoryUser>;
+    /** Users that can be picked as assignee (active only). */
+    assignable: DirectoryUser[];
+    /** Display name for a user id ("You" for the current user when `youLabel`). */
+    nameOf(id: number | null | undefined, opts?: {
+        youLabel?: boolean;
+    }): string | null;
+}
+/** Pure builder (exported for tests). */
+export declare function buildDirectory(me: User | null, isAdmin: boolean, list: readonly DirectoryUser[] | undefined): Directory;
+/**
+ * Team member lookup for the inbox. Admins use the full `GET /api/users`; every other role
+ * uses the public `GET /api/users/directory` ({id, displayName, role, disabled}). Ids that are
+ * still unknown render as "Agent #<id>".
+ */
+export declare function useDirectory(): Directory;

package/dist-lib/types/inbox/useSwipeReply.d.ts

@@ -0,0 +1,11 @@
+import type React from 'react';
+/** Swipe distance (px) that starts a reply, and the furthest the bubble follows the finger. */
+export declare const SWIPE_TRIGGER_PX = 56;
+/**
+ * Touch gestures that start a reply, like WhatsApp: swipe the message right, or press and hold.
+ * Mouse and pen are ignored (desktop uses the Reply button). Vertical movement keeps scrolling.
+ */
+export declare function useSwipeReply(onReply: (() => void) | undefined): {
+    offset: number;
+    handlers: React.HTMLAttributes<HTMLElement>;
+};

package/dist-lib/types/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Public web API (`@ezychat/web`): everything another product build needs to add UI to the inbox
+ * without forking Lite or deep-importing its modules.
+ */
+export { createInboxApp, type CreateInboxAppOptions } from './create-app';
+export { EXTENSION_NAME_PATTERN, WEB_EXTENSION_ADMIN_SECTIONS, WebExtensionError, extensionKeyPrefix, extensionPath, useExtensionTranslation, validateWebExtensions, type ExtensionTranslate, type WebExtension, type WebExtensionAdminSection, type WebExtensionAgent, type WebExtensionAgentSection, type WebExtensionCatalogs, type WebExtensionLockScreenProps, type WebExtensionNavBadge, type WebExtensionNavItem, type WebExtensionRoute, type WebExtensionSettingsSection, } from './extensions';
+export { useAppLinks } from './lib/app-links';
+export { LITE_APP_LINKS, type AppLinks } from './lib/links';
+export { PausedScreen } from './access/AccessGate';
+export { SlimBanner } from './access/BannerSlot';
+export { AppMark, AuthShell } from './auth/AuthShell';
+export { useTranslation, Trans } from 'react-i18next';
+export { useAuth, type AuthValue } from './auth/AuthProvider';
+export { api, ApiError, errorMessage } from './api/client';
+export { cn } from './lib/utils';
+export { Banner, EmptyState, PageHeader, ResponsiveDialog, ResponsiveTable, SegmentedControl, StatusDot, type Column, type SegmentedOption, type StatusTone, } from './components/app';
+export { ErrorBoundary } from './components/app/ErrorBoundary';
+export * from './components/ui/alert-dialog';
+export * from './components/ui/avatar';
+export * from './components/ui/badge';
+export * from './components/ui/button';
+export * from './components/ui/card';
+export * from './components/ui/checkbox';
+export * from './components/ui/command';
+export * from './components/ui/dialog';
+export * from './components/ui/drawer';
+export * from './components/ui/dropdown-menu';
+export * from './components/ui/input';
+export * from './components/ui/label';
+export * from './components/ui/popover';
+export * from './components/ui/progress';
+export * from './components/ui/radio-group';
+export * from './components/ui/scroll-area';
+export * from './components/ui/select';
+export * from './components/ui/separator';
+export * from './components/ui/sheet';
+export * from './components/ui/skeleton';
+export * from './components/ui/sonner';
+export * from './components/ui/switch';
+export * from './components/ui/table';
+export * from './components/ui/tabs';
+export * from './components/ui/textarea';
+export * from './components/ui/tooltip';

package/dist-lib/types/lib/ai-handoff.d.ts

@@ -0,0 +1,4 @@
+import { AiHandoffReason } from '@ezychat/shared';
+/** Short, localized reason why the AI handed a chat to the team (chat events and Try it). */
+export declare function handoffReasonLabel(reason: AiHandoffReason): string;
+export declare function isHandoffReason(value: unknown): value is AiHandoffReason;

package/dist-lib/types/lib/app-links.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from 'react';
+import { type AppLinks } from './links';
+/** Supplies the product's outside links (`createInboxApp({ links })`); Lite's links otherwise. */
+export declare function AppLinksProvider({ links, children }: {
+    links: AppLinks;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The product's outside links. A `null` link is hidden by the component that shows it. */
+export declare function useAppLinks(): AppLinks;

package/dist-lib/types/lib/desktop-updates.d.ts

@@ -0,0 +1,15 @@
+import type { DesktopUpdatesBridge, DesktopUpdateState } from '@ezychat/shared';
+declare global {
+    interface Window {
+        watiUpdates?: DesktopUpdatesBridge;
+    }
+}
+/** Electron supplies this bridge; browser and phone clients never check GitHub. */
+export declare function useDesktopUpdates(): {
+    state: DesktopUpdateState | null;
+    error: string | null;
+    check: () => Promise<void>;
+    open: (action: "download" | "release") => Promise<void>;
+    install: () => Promise<void>;
+    cancelDownload: () => Promise<void>;
+};

package/dist-lib/types/lib/error-reporter.d.ts

@@ -0,0 +1,6 @@
+import type { ClientErrorBody } from '@ezychat/shared';
+export declare function reportClientError(e: Omit<ClientErrorBody, 'route' | 'appVersion'> & {
+    route?: string;
+}): void;
+/** Global handlers for uncaught errors and unhandled promise rejections. Call once at startup. */
+export declare function installGlobalErrorReporting(): void;

package/dist-lib/types/lib/format.d.ts

@@ -0,0 +1,20 @@
+/** Short list-style time: "14:05" today, "Yesterday", "3 Oct" this year, else "3 Oct 2025". */
+export declare function formatListTime(ts: number | null | undefined, now?: Date): string;
+export declare function formatTime(ts: number): string;
+/** Date only, always with the year: "9 Oct 2026". */
+export declare function formatDate(ts: number): string;
+export declare function formatDateTime(ts: number): string;
+/** Day separator label: "Today", "Yesterday", or "Monday 3 October 2026". */
+export declare function formatDay(ts: number, now?: Date): string;
+/** "5 minutes ago" in the active language; "just now" for the last minute. */
+export declare function formatRelative(ts: number): string;
+/** Number in the active UI language, e.g. "1,234" / "1.234". */
+export declare function formatNumber(n: number, options?: Intl.NumberFormatOptions): string;
+export declare function formatBytes(n: number): string;
+/**
+ * Up to two initials from a display name, letters only: "(kingsly) Oyen Jarvis" → "KJ",
+ * "陈伟明 Chen Wei Ming" → "陈". Empty when the name has no letters (a phone number, a WhatsApp
+ * ID, emoji only): callers show a person icon instead.
+ */
+export declare function initials(name: string): string;
+export declare function truncate(s: string, max: number): string;