tempest-react-sdk 0.3.0 → 0.4.0

package/dist/{index.d.ts → tempest-react-sdk.d.ts}

@@ -1,17 +1,26 @@
 import { ButtonHTMLAttributes } from 'react';
 import { Component } from 'react';
 import { ComponentType } from 'react';
+import { Control } from 'react-hook-form';
+import { Controller } from 'react-hook-form';
+import { ControllerRenderProps } from 'react-hook-form';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'dexie';
 import { DefaultOptions } from '@tanstack/react-query';
 import { ErrorInfo } from 'react';
+import { FieldArrayWithId } from 'react-hook-form';
+import { FieldError } from 'react-hook-form';
+import { FieldErrors } from 'react-hook-form';
+import { FieldPath } from 'react-hook-form';
 import { FieldValues } from 'react-hook-form';
 import { FormHTMLAttributes } from 'react';
+import { FormProvider } from 'react-hook-form';
 import { ForwardRefExoticComponent } from 'react';
 import { HTMLAttributes } from 'react';
 import { InputHTMLAttributes } from 'react';
 import { JSX } from 'react/jsx-runtime';
 import { lazy } from 'react';
+import { Path } from 'react-hook-form';
 import { PersistOptions } from 'zustand/middleware';
 import { QueryClient } from '@tanstack/react-query';
 import { ReactElement } from 'react';
@@ -21,11 +30,19 @@ import { RefAttributes } from 'react';
 import { RefObject } from 'react';
 import { SelectHTMLAttributes } from 'react';
 import { StoreApi } from 'zustand';
+import { SubmitHandler } from 'react-hook-form';
 import { Table as Table_2 } from 'dexie';
 import { TextareaHTMLAttributes } from 'react';
 import { UseBoundStore } from 'zustand';
+import { useFieldArray } from 'react-hook-form';
+import { UseFieldArrayReturn } from 'react-hook-form';
+import { useForm } from 'react-hook-form';
+import { useFormContext } from 'react-hook-form';
 import { UseFormProps } from 'react-hook-form';
+import { UseFormRegister } from 'react-hook-form';
 import { UseFormReturn } from 'react-hook-form';
+import { useFormState } from 'react-hook-form';
+import { useWatch } from 'react-hook-form';
 import { z } from 'zod';
 
 /**
@@ -119,6 +136,40 @@ export declare interface ApiError {
     body?: unknown;
 }
 
+/**
+ * Full app layout — composes [[Navbar]] + [[Sidebar]] + content +
+ * [[BottomNavigation]] + footer with responsive behaviour:
+ *
+ * - **Desktop (`>= sidebarBreakpoint`)**: navbar + sidebar + main + footer.
+ * - **Mobile (`< sidebarBreakpoint`)**: navbar + main + bottom nav + footer
+ *   (sidebar hidden — app should expose it via `<Drawer>` from a hamburger).
+ *
+ * @example
+ * <AppShell
+ *     navbar={<Navbar logo={<Brand />} actions={<UserMenu />} />}
+ *     sidebar={<Sidebar items={...} value={tab} onChange={setTab} />}
+ *     bottomNav={<BottomNavigation items={...} value={tab} onChange={setTab} />}
+ *     footer={<Footer />}
+ * >
+ *     <Page title="Dashboard">{content}</Page>
+ * </AppShell>
+ */
+export declare function AppShell({ navbar, sidebar, bottomNav, footer, sidebarBreakpoint, className, children, ...props }: AppShellProps): JSX.Element;
+
+export declare interface AppShellProps extends HTMLAttributes<HTMLDivElement> {
+    /** Top navigation bar (Navbar / custom). Renders on every breakpoint. */
+    navbar?: ReactNode;
+    /** Side navigation (Sidebar). Hidden below `md` — pair with `<Drawer>` for mobile. */
+    sidebar?: ReactNode;
+    /** Mobile-only bottom navigation (BottomNavigation). Hidden at `md+`. */
+    bottomNav?: ReactNode;
+    /** Footer rendered after the main content. */
+    footer?: ReactNode;
+    /** Breakpoint at which the sidebar appears. Default `"md"`. */
+    sidebarBreakpoint?: "sm" | "md" | "lg" | "xl";
+    children?: ReactNode;
+}
+
 /**
  * Preserve a constant aspect ratio for media (images, video, embeds). The
  * inner child stretches to fill the box. Uses the native `aspect-ratio`
@@ -236,6 +287,105 @@ export declare type BadgeSize = "sm" | "md" | "lg";
 
 export declare type BadgeVariant = "neutral" | "primary" | "success" | "warning" | "danger" | "info";
 
+/**
+ * Top-of-page persistent notice. Use for environment indicators
+ * ("Você está em sandbox"), maintenance windows, account warnings.
+ * Different from `Alert` (inline near a field) and `Toast` (transient).
+ *
+ * @example
+ * <Banner variant="warning" dismissible onDismiss={() => setOpen(false)}>
+ *     Sua assinatura expira em 3 dias.
+ * </Banner>
+ */
+export declare function Banner({ variant, icon, title, action, dismissible, onDismiss, className, children, ...props }: BannerProps): JSX.Element | null;
+
+export declare interface BannerProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Visual variant. Default `"info"`. */
+    variant?: BannerVariant;
+    /** Optional leading icon. */
+    icon?: ReactNode;
+    /** Optional title displayed before description. */
+    title?: ReactNode;
+    /** Optional action button rendered on the right side. */
+    action?: ReactNode;
+    /** Show a dismiss button on the right. */
+    dismissible?: boolean;
+    /** Callback fired when the dismiss button is clicked. */
+    onDismiss?: () => void;
+    children?: ReactNode;
+}
+
+export declare type BannerVariant = "info" | "success" | "warning" | "danger";
+
+/**
+ * Fixed-bottom mobile tab bar. 3–5 items recommended. Pair with
+ * `<Show below="md">` to render only on mobile.
+ *
+ * @example
+ * <Show below="md">
+ *     <BottomNavigation
+ *         items={[
+ *             { key: "home", label: "Início", icon: <Home /> },
+ *             { key: "search", label: "Buscar", icon: <Search /> },
+ *             { key: "profile", label: "Perfil", icon: <User /> },
+ *         ]}
+ *         value={tab}
+ *         onChange={setTab}
+ *     />
+ * </Show>
+ */
+export declare function BottomNavigation({ items, value, onChange, showLabels, className, ...props }: BottomNavigationProps): JSX.Element;
+
+export declare interface BottomNavigationItem {
+    /** Unique identifier — used as React key and for value matching. */
+    key: string;
+    /** Visible label. */
+    label: ReactNode;
+    /** Icon rendered above the label. */
+    icon?: ReactNode;
+    /** Optional badge content rendered above the icon. */
+    badge?: ReactNode;
+    /** When true, the item is not selectable. */
+    disabled?: boolean;
+}
+
+export declare interface BottomNavigationProps extends Omit<HTMLAttributes<HTMLElement>, "onChange"> {
+    items: BottomNavigationItem[];
+    /** Selected key. */
+    value: string;
+    /** Called with the new selected key on click. */
+    onChange: (key: string) => void;
+    /** Show label below each icon. Default `true`. */
+    showLabels?: boolean;
+}
+
+/**
+ * Slide-up modal panel — mobile-style sheet anchored to the bottom edge.
+ * Uses portal + safe-area padding + scroll lock.
+ *
+ * @example
+ * <BottomSheet open={open} onClose={() => setOpen(false)} title="Filters">
+ *     <FilterForm />
+ * </BottomSheet>
+ */
+export declare function BottomSheet({ open, onClose, title, showHandle, dismissOnBackdrop, dismissOnEsc, className, children, ...props }: BottomSheetProps): ReactPortal | null;
+
+export declare interface BottomSheetProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** Controlled open state. */
+    open: boolean;
+    /** Fires when user dismisses (backdrop click, Esc, swipe). */
+    onClose: () => void;
+    /** Optional title rendered at the top of the sheet. */
+    title?: ReactNode;
+    /** Show a drag handle indicator at the top. Default `true`. */
+    showHandle?: boolean;
+    /** When `true`, clicking the backdrop closes the sheet. Default `true`. */
+    dismissOnBackdrop?: boolean;
+    /** When `true`, pressing Esc closes the sheet. Default `true`. */
+    dismissOnEsc?: boolean;
+    children?: ReactNode;
+}
+
 export declare interface BreadcrumbItem {
     label: ReactNode;
     href?: string;
@@ -484,6 +634,10 @@ export declare interface ContainerProps extends HTMLAttributes<HTMLDivElement> {
 
 export declare type ContainerSize = "sm" | "md" | "lg" | "xl" | "full";
 
+export { Control }
+
+export { Controller }
+
 export declare const CPFInput: ForwardRefExoticComponent<Omit<InputProps, "value" | "onChange"> & {
 value: string;
 onChange: (value: string) => void;
@@ -1089,6 +1243,16 @@ export declare interface FeatureFlagsProviderProps {
     children: ReactNode;
 }
 
+export { FieldArrayWithId }
+
+export { FieldError }
+
+export { FieldErrors }
+
+export { FieldPath }
+
+export { FieldValues }
+
 /**
  * Drag-and-drop file dropzone. Pair with `uploadWithProgress` from the SDK
  * to wire actual uploads with byte-level progress.
@@ -1214,11 +1378,70 @@ export declare function formatPercent(value: number): string;
  */
 export declare function formatPhone(value: string): string;
 
+/**
+ * Glue between `react-hook-form` `Controller` and the SDK's controlled
+ * components. Wraps any control that accepts `{ value, onChange, label,
+ * error }` and routes RHF state into it — eliminating the per-field
+ * `<Controller render={...} />` boilerplate.
+ *
+ * @example
+ * const form = useZodForm(schema);
+ * <FormProvider {...form}>
+ *     <Form>
+ *         <FormField name="email" label="Email" required>
+ *             <Input type="email" />
+ *         </FormField>
+ *         <FormField name="cep" label="CEP">
+ *             <CEPInput />
+ *         </FormField>
+ *     </Form>
+ * </FormProvider>;
+ */
+export declare function FormField<TValues extends FieldValues = FieldValues, TName extends FieldPath<TValues> = FieldPath<TValues>>({ name, label, helperText, required, control, children }: FormFieldProps<TValues, TName>): JSX.Element;
+
+export declare interface FormFieldChildProps {
+    name: string;
+    value: unknown;
+    onChange: (...args: unknown[]) => void;
+    onBlur: () => void;
+    ref: ControllerRenderProps["ref"];
+    error?: string;
+    "aria-invalid"?: boolean;
+    "aria-describedby"?: string;
+    label?: ReactNode;
+    helperText?: ReactNode;
+    required?: boolean;
+    id?: string;
+}
+
+export declare interface FormFieldProps<TValues extends FieldValues = FieldValues, TName extends FieldPath<TValues> = FieldPath<TValues>> {
+    /** Field name (dot path supported, e.g. `"address.city"`). */
+    name: TName;
+    /** Field label rendered by the wrapped control. */
+    label?: ReactNode;
+    /** Helper text rendered by the wrapped control when there is no error. */
+    helperText?: ReactNode;
+    /** When `true`, marks the control as required (visual hint + native attribute). */
+    required?: boolean;
+    /**
+     * Explicit `control` from `useForm()` / `useZodForm()`. Optional when a
+     * `FormProvider` is in the tree.
+     */
+    control?: Control<TValues>;
+    /**
+     * The control to render. Receives `{ value, onChange, onBlur, ref, error, ... }`
+     * via `cloneElement`. Pass `<Input />`, `<Select />`, masked inputs, etc.
+     */
+    children: ReactElement;
+}
+
 export declare type FormLayout = "stack" | "inline" | "grid";
 
 export declare interface FormProps extends FormHTMLAttributes<HTMLFormElement>, LayoutProps {
 }
 
+export { FormProvider }
+
 /**
  * Forces a horizontal row regardless of parent layout — useful for grouping
  * two short fields side-by-side inside an otherwise stacked form (e.g. CEP +
@@ -1286,6 +1509,71 @@ export declare interface GetInitialThemeOptions {
     defaultTheme?: ThemeMode;
 }
 
+/**
+ * Thin wrapper over `@react-oauth/google`'s `<GoogleLogin>` that:
+ *
+ * 1. Normalises the success payload into [[OAuthCredential]] (`idToken`,
+ *    `provider: "google"`, `raw`).
+ * 2. Normalises errors into [[OAuthError]].
+ * 3. Lets you pass `GoogleLogin` via the `component` prop, so the SDK does
+ *    not declare `@react-oauth/google` as a peer dep — apps that don't use
+ *    Google never pay for it.
+ *
+ * @example
+ * import { GoogleLogin, GoogleOAuthProvider } from "@react-oauth/google";
+ * import { GoogleSignIn } from "tempest-react-sdk";
+ *
+ * <GoogleOAuthProvider clientId={import.meta.env.VITE_GOOGLE_CLIENT_ID}>
+ *     <GoogleSignIn
+ *         component={GoogleLogin}
+ *         onSuccess={async ({ idToken }) => {
+ *             await api.post("/auth/google", { body: { id_token: idToken } });
+ *         }}
+ *         onError={(err) => toast.error(err.message)}
+ *     />
+ * </GoogleOAuthProvider>
+ */
+export declare function GoogleSignIn({ component: Component, onSuccess, onError, locale, theme, text, shape, size, disableOneTap, width, className, style, }: GoogleSignInProps): JSX.Element;
+
+export declare interface GoogleSignInProps {
+    /**
+     * `GoogleLogin` component from `@react-oauth/google`. The caller imports
+     * it and passes it through so the SDK doesn't take `@react-oauth/google`
+     * as a peer dep.
+     */
+    component: (props: Record<string, unknown>) => ReactNode;
+    /** Fired with the validated credential on success. */
+    onSuccess: (credential: OAuthCredential) => void | Promise<void>;
+    /** Fired with a normalised error on failure. */
+    onError?: (error: OAuthError) => void;
+    /** Optional locale override (e.g. `"pt-BR"`). Falls back to browser locale. */
+    locale?: string;
+    /** Visual theme — passed through to `<GoogleLogin>`. */
+    theme?: GoogleSignInTheme;
+    /** Button text variant. */
+    text?: GoogleSignInText;
+    /** Button shape. */
+    shape?: GoogleSignInShape;
+    /** Button size. */
+    size?: GoogleSignInSize;
+    /** Disable Google's "One Tap" auto-prompt. Default `false`. */
+    disableOneTap?: boolean;
+    /** Optional `width` override (px) — Google's button is fixed-width. */
+    width?: number;
+    /** Optional className applied to the wrapper. */
+    className?: string;
+    /** Optional inline style applied to the wrapper. */
+    style?: CSSProperties;
+}
+
+export declare type GoogleSignInShape = "rectangular" | "pill" | "circle" | "square";
+
+export declare type GoogleSignInSize = "large" | "medium" | "small";
+
+export declare type GoogleSignInText = "signin_with" | "signup_with" | "continue_with" | "signin";
+
+export declare type GoogleSignInTheme = "filled_blue" | "filled_black" | "outline";
+
 /** Simple CSS-Grid wrapper for equal-width or custom column layouts. */
 export declare function Grid({ columns, gap, className, style, children, ...props }: GridProps): JSX.Element;
 
@@ -1602,6 +1890,56 @@ export declare interface MoneyInputProps extends Omit<InputProps, "value" | "onC
     locale?: string;
 }
 
+/**
+ * Top app bar. Three-slot layout (logo / nav / actions) that collapses
+ * gracefully on mobile (nav slot wraps below).
+ *
+ * @example
+ * <Navbar
+ *     logo={<img src="/logo.svg" alt="App" />}
+ *     nav={<NavLinks />}
+ *     actions={<UserMenu />}
+ * />
+ */
+export declare function Navbar({ logo, nav, actions, sticky, tone, bordered, className, ...props }: NavbarProps): JSX.Element;
+
+export declare interface NavbarProps extends HTMLAttributes<HTMLElement> {
+    /** Left slot — typically logo + brand name. */
+    logo?: ReactNode;
+    /** Center slot — typically nav links. */
+    nav?: ReactNode;
+    /** Right slot — typically user menu / actions. */
+    actions?: ReactNode;
+    /** Make the bar sticky at the top of the scroll container. Default `true`. */
+    sticky?: boolean;
+    /** Visual tone. Default `"surface"`. */
+    tone?: NavbarTone;
+    /** When set, renders a thin bottom border. Default `true`. */
+    bordered?: boolean;
+}
+
+export declare type NavbarTone = "surface" | "primary" | "transparent";
+
+export declare interface OAuthCredential {
+    /** Provider-issued ID token (JWT). */
+    idToken: string;
+    /** Provider name (e.g. `"google"`, `"facebook"`). */
+    provider: string;
+    /** Raw response from the provider's SDK — opaque, for app-level inspection. */
+    raw?: unknown;
+}
+
+export declare interface OAuthError {
+    /** Provider name. */
+    provider: string;
+    /** Provider-specific error code, when available. */
+    code?: string;
+    /** Human-readable message. */
+    message: string;
+    /** Raw underlying error object. */
+    raw?: unknown;
+}
+
 export declare interface OfflineStore<TItem, TKey extends string | number> {
     /** Insert or replace a record. */
     put: (item: TItem, owner?: string) => Promise<TKey>;
@@ -1650,6 +1988,35 @@ export declare interface OfflineStoreConfig<TItem> {
     ownerField?: keyof TItem & string;
 }
 
+/**
+ * Page wrapper with header + (optional) toolbar + content + footer. Pairs
+ * with `Container` when you want a max-width content well.
+ *
+ * @example
+ * <Page title="Pedidos" description="Acompanhe seus pedidos" actions={<Button>Novo</Button>}>
+ *     <Table {...} />
+ * </Page>
+ */
+export declare function Page({ title, eyebrow, description, actions, toolbar, footer, padded, className, children, ...props }: PageProps): JSX.Element;
+
+export declare interface PageProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /** Page title rendered as `<h1>`. */
+    title?: ReactNode;
+    /** Optional subtitle / breadcrumbs slot rendered above the title. */
+    eyebrow?: ReactNode;
+    /** Optional description rendered below the title. */
+    description?: ReactNode;
+    /** Right-side actions slot in the header (buttons, menus). */
+    actions?: ReactNode;
+    /** Sticky tab bar / filter row rendered just below the header. */
+    toolbar?: ReactNode;
+    /** Footer slot rendered at the bottom of the content area. */
+    footer?: ReactNode;
+    /** Page-level padding. Default `true`. */
+    padded?: boolean;
+    children?: ReactNode;
+}
+
 /**
  * Numeric pagination controls. Pair with {@link usePagination} for state.
  */
@@ -1682,6 +2049,8 @@ export declare interface PaginationProps {
  */
 export declare function parseResponse<TSchema extends z.ZodTypeAny>(schema: TSchema, raw: unknown, context: string): z.infer<TSchema>;
 
+export { Path }
+
 export declare const PhoneInput: ForwardRefExoticComponent<Omit<InputProps, "value" | "onChange"> & {
 value: string;
 onChange: (value: string) => void;
@@ -1991,6 +2360,28 @@ export declare interface RetryOptions {
     signal?: AbortSignal;
 }
 
+/**
+ * Apply `env(safe-area-inset-*)` padding so content avoids iOS notch /
+ * Android navbar / device chrome. Wrap the outermost container of pages
+ * with sticky headers/footers.
+ *
+ * @example
+ * <SafeArea edges={["top"]}>
+ *     <Navbar />
+ * </SafeArea>
+ */
+export declare function SafeArea({ edges, inline, className, children, ...props }: SafeAreaProps): JSX.Element;
+
+export declare type SafeAreaEdge = "top" | "right" | "bottom" | "left";
+
+export declare interface SafeAreaProps extends HTMLAttributes<HTMLDivElement> {
+    /** Edges to pad. Default `["top","right","bottom","left"]` (all). */
+    edges?: SafeAreaEdge[];
+    /** Render as inline (use `display: contents`). */
+    inline?: boolean;
+    children?: ReactNode;
+}
+
 /**
  * Search input with magnifier icon and a clear button. Controlled component:
  * pass `value` and `onChange`.
@@ -2093,6 +2484,51 @@ export declare interface ShowProps {
     children: ReactNode;
 }
 
+/**
+ * Desktop sidebar navigation. Pair with `<Show above="md">` and a `Drawer`
+ * for mobile.
+ *
+ * @example
+ * const [tab, setTab] = useState("home");
+ * <Show above="md">
+ *     <Sidebar
+ *         header={<Brand />}
+ *         items={[{ key: "home", label: "Home", icon: <Home /> }]}
+ *         value={tab}
+ *         onChange={setTab}
+ *     />
+ * </Show>
+ */
+export declare function Sidebar({ header, items, value, onChange, footer, collapsed, width, collapsedWidth, className, style, ...props }: SidebarProps): JSX.Element;
+
+export declare interface SidebarItem {
+    key: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    badge?: ReactNode;
+    disabled?: boolean;
+    href?: string;
+}
+
+export declare interface SidebarProps extends Omit<HTMLAttributes<HTMLElement>, "onChange"> {
+    /** Top slot — typically the logo + brand. */
+    header?: ReactNode;
+    /** Navigation items. */
+    items: SidebarItem[];
+    /** Active item key. */
+    value?: string;
+    /** Fires when an item is clicked. Receives the item's `key`. */
+    onChange?: (key: string) => void;
+    /** Bottom slot — typically settings/profile/logout. */
+    footer?: ReactNode;
+    /** Collapsed mode — only icons visible. Default `false`. */
+    collapsed?: boolean;
+    /** Width when expanded, in pixels or any CSS length. Default `240px`. */
+    width?: number | string;
+    /** Width when collapsed, in pixels or any CSS length. Default `64px`. */
+    collapsedWidth?: number | string;
+}
+
 /** Loading placeholder block. Use `variant="text"` for inline lines, `circle` for avatars. */
 export declare function Skeleton({ variant, width, height, className, style }: SkeletonProps): JSX.Element;
 
@@ -2169,6 +2605,32 @@ export declare const STALE_TIME: {
     readonly INFINITE: number;
 };
 
+/**
+ * KPI card. Dashboard widget showing a label + big value + optional
+ * delta/trend and hint.
+ *
+ * @example
+ * <Stat label="Receita" value="R$ 12.345" delta="+12,4%" trend="up" hint="vs. mês anterior" />
+ */
+export declare function Stat({ label, value, delta, trend, hint, icon, className, ...props }: StatProps): JSX.Element;
+
+export declare interface StatProps extends HTMLAttributes<HTMLDivElement> {
+    /** Metric label (e.g. "Revenue", "Active users"). */
+    label: ReactNode;
+    /** Metric value (e.g. "R$ 12.345", "1.2k"). */
+    value: ReactNode;
+    /** Optional comparison delta — when set, renders alongside the value. */
+    delta?: ReactNode;
+    /** Trend direction for the delta. Default inferred from delta string. */
+    trend?: StatTrend;
+    /** Optional supporting context line below the value. */
+    hint?: ReactNode;
+    /** Optional leading icon. */
+    icon?: ReactNode;
+}
+
+export declare type StatTrend = "up" | "down" | "flat";
+
 export declare interface StepItem {
     label: ReactNode;
 }
@@ -2201,6 +2663,8 @@ export declare const storage: {
     remove(key: string): void;
 };
 
+export { SubmitHandler }
+
 /** Toggle switch backed by a checkbox input. Accessible via keyboard. */
 export declare const Switch: ForwardRefExoticComponent<SwitchProps & RefAttributes<HTMLInputElement>>;
 
@@ -2275,6 +2739,33 @@ export declare interface TabsProps {
     className?: string;
 }
 
+/**
+ * Removable chip — used for filter tokens, applied search filters,
+ * selected entities. Different from `Badge` (status-only, not removable).
+ *
+ * @example
+ * <Tag variant="primary" onRemove={() => removeFilter("sao-paulo")}>
+ *     São Paulo
+ * </Tag>
+ */
+export declare function Tag({ variant, size, onRemove, removeLabel, className, children, ...props }: TagProps): JSX.Element;
+
+export declare interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "onRemove"> {
+    /** Visual variant. Default `"neutral"`. */
+    variant?: TagVariant;
+    /** Visual size. Default `"md"`. */
+    size?: TagSize;
+    /** When set, renders a close button that fires this callback. */
+    onRemove?: () => void;
+    /** Custom remove label for screen readers. Default `"Remover"`. */
+    removeLabel?: string;
+    children?: ReactNode;
+}
+
+export declare type TagSize = "sm" | "md" | "lg";
+
+export declare type TagVariant = "neutral" | "primary" | "success" | "warning" | "danger" | "info";
+
 export declare interface TelemetryAdapter {
     /** Optional. Called when the provider mounts. */
     init?: () => void | Promise<void>;
@@ -2681,6 +3172,10 @@ export declare interface UseEventStreamResult<T> {
  */
 export declare function useFeatureFlag(key: string, defaultValue?: boolean): boolean;
 
+export { useFieldArray }
+
+export { UseFieldArrayReturn }
+
 /**
  * Read a typed flag value (string / number / boolean / null) and re-render
  * on change.
@@ -2694,6 +3189,18 @@ export declare function useFlagValue<T extends FlagValue = FlagValue>(key: strin
  */
 export declare function useFocusTrap(containerRef: RefObject<HTMLElement | null>, active: boolean): void;
 
+export { useForm }
+
+export { useFormContext }
+
+export { UseFormProps }
+
+export { UseFormRegister }
+
+export { UseFormReturn }
+
+export { useFormState }
+
 /** React hook around the Geolocation API. */
 export declare function useGeolocation(options?: UseGeolocationOptions): GeolocationState;
 
@@ -2766,6 +3273,55 @@ export declare function useLocalStorage<T>(key: string, defaultValue: T, options
  */
 export declare function useMediaQuery(query: string): boolean;
 
+/**
+ * Run an OAuth-callback "exchange" exactly once on mount. Designed for
+ * `/callback` routes that receive provider redirects and need to swap a
+ * code/token for an app session via the backend.
+ *
+ * Survives React StrictMode double-mounting in dev — uses a ref guard to
+ * ensure `exchange` runs once.
+ *
+ * @example
+ * function OAuthCallback() {
+ *     const { loading, error } = useOAuthCallback({
+ *         exchange: async () => {
+ *             const code = new URLSearchParams(location.search).get("code")!;
+ *             return api.post("/auth/google/exchange", { body: { code } });
+ *         },
+ *         onSuccess: ({ token, user }) => {
+ *             useAuthStore.getState().setSession({ user, token });
+ *             navigate("/dashboard", { replace: true });
+ *         },
+ *         onError: () => navigate("/login?error=oauth", { replace: true }),
+ *     });
+ *
+ *     if (loading) return <Spinner />;
+ *     if (error) return <ErrorState description="OAuth falhou" />;
+ *     return null;
+ * }
+ */
+export declare function useOAuthCallback<T>(options: UseOAuthCallbackOptions<T>): UseOAuthCallbackResult<T>;
+
+export declare interface UseOAuthCallbackOptions<T> {
+    /** Function that exchanges the provider response for an app session. Called once on mount. */
+    exchange: () => Promise<T>;
+    /** Fired with the result on success. Receives the value resolved by `exchange`. */
+    onSuccess?: (result: T) => void | Promise<void>;
+    /** Fired when `exchange` throws or rejects. */
+    onError?: (error: unknown) => void;
+}
+
+export declare interface UseOAuthCallbackResult<T> {
+    /** `true` while the exchange promise is pending. */
+    loading: boolean;
+    /** Last resolved value, when `status === "success"`. */
+    data: T | null;
+    /** Last rejection reason, when `status === "error"`. */
+    error: unknown;
+    /** Aggregated state — `"pending"`, `"success"`, or `"error"`. */
+    status: "pending" | "success" | "error";
+}
+
 /**
  * Track the browser's `navigator.onLine` value and re-render on changes.
  * Returns `true` during SSR (assumption: server is online).
@@ -2914,6 +3470,8 @@ export declare interface UseViaCEPResult {
     reset: () => void;
 }
 
+export { useWatch }
+
 /**
  * React hook around {@link createWebSocket}. Manages the connection lifecycle
  * for the host component and tears it down on unmount.