@asgardeo/react 0.2.4 → 0.4.0

package/dist/{esm/types/components/SignInButton/SignInButton.d.ts → components/primitives/PasswordField/PasswordField.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com). All Rights Reserved.
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
  *
  * WSO2 LLC. licenses this file to you under the Apache License,
  * Version 2.0 (the "License"); you may not use this file except
@@ -15,15 +15,17 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-import { ReactElement } from 'react';
-import './sign-in-button.scss';
-import { SignInButtonProps } from '../../models/sign-in';
+import { FC } from 'react';
+import { TextFieldProps } from '../TextField/TextField';
+export interface PasswordFieldProps extends Omit<TextFieldProps, 'type' | 'endIcon' | 'onEndIconClick' | 'onChange'> {
+    /**
+     * Callback function when the field value changes
+     */
+    onChange: (value: string) => void;
+}
 /**
- * SignInButton component. This button will render a modal with the SignIn component when clicked.
- *
- * @param {Object} props - Component props.
- * @param {ReactElement} props.customComponent - Optional custom component to be rendered.
- * @returns {ReactElement} Rendered SignInButton component.
+ * Password field component with show/hide toggle functionality.
+ * This component extends TextField and adds password visibility toggle functionality.
  */
-declare const SignInButton: (props: SignInButtonProps) => ReactElement;
-export default SignInButton;
+declare const PasswordField: FC<PasswordFieldProps>;
+export default PasswordField;

package/dist/components/primitives/Popover/Popover.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import React from 'react';
+import { UseFloatingReturn, UseInteractionsReturn } from '@floating-ui/react';
+interface DialogOptions {
+    initialOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+interface DialogHookReturn extends UseFloatingReturn, UseInteractionsReturn {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    labelId: string | undefined;
+    descriptionId: string | undefined;
+    setLabelId: React.Dispatch<React.SetStateAction<string | undefined>>;
+    setDescriptionId: React.Dispatch<React.SetStateAction<string | undefined>>;
+}
+export declare function useDialog({ initialOpen, open: controlledOpen, onOpenChange: setControlledOpen, }?: DialogOptions): DialogHookReturn;
+interface PopoverOptions {
+    initialOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    placement?: 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+    offset?: number;
+}
+interface PopoverHookReturn extends UseFloatingReturn, UseInteractionsReturn {
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    labelId: string | undefined;
+    descriptionId: string | undefined;
+    setLabelId: React.Dispatch<React.SetStateAction<string | undefined>>;
+    setDescriptionId: React.Dispatch<React.SetStateAction<string | undefined>>;
+}
+export declare function usePopover({ initialOpen, open: controlledOpen, onOpenChange: setControlledOpen, placement, offset: offsetValue, }?: PopoverOptions): PopoverHookReturn;
+export declare const useDialogContext: () => DialogHookReturn;
+export declare const usePopoverContext: () => PopoverHookReturn;
+export declare function Dialog({ children, ...options }: {
+    children: React.ReactNode;
+} & DialogOptions): import("react/jsx-runtime").JSX.Element;
+interface DialogTriggerProps {
+    children: React.ReactNode;
+    asChild?: boolean;
+}
+export declare const DialogTrigger: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLElement> & DialogTriggerProps, "ref"> & React.RefAttributes<HTMLElement>>;
+export declare const DialogContent: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare function Popover({ children, ...options }: {
+    children: React.ReactNode;
+} & PopoverOptions): import("react/jsx-runtime").JSX.Element;
+interface PopoverTriggerProps {
+    children: React.ReactNode;
+    asChild?: boolean;
+}
+export declare const PopoverTrigger: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLElement> & PopoverTriggerProps, "ref"> & React.RefAttributes<HTMLElement>>;
+export declare const PopoverContent: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+export declare const PopoverHeading: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const DialogHeading: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;
+export declare const PopoverDescription: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const DialogDescription: React.ForwardRefExoticComponent<Omit<React.HTMLProps<HTMLParagraphElement>, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
+export declare const PopoverClose: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+export declare const DialogClose: React.ForwardRefExoticComponent<React.ButtonHTMLAttributes<HTMLButtonElement> & React.RefAttributes<HTMLButtonElement>>;
+interface LegacyPopoverProps {
+    isOpen: boolean;
+    children: React.ReactNode;
+    onClose: () => void;
+    className?: string;
+    mode?: 'modal' | 'dropdown';
+    trigger?: HTMLElement | null;
+    placement?: 'top' | 'bottom' | 'left' | 'right' | 'top-start' | 'top-end' | 'bottom-start' | 'bottom-end';
+    offset?: number;
+}
+declare const LegacyPopoverHeader: React.FC<{
+    children?: React.ReactNode;
+}>;
+declare const LegacyPopoverContent: React.FC<{
+    children: React.ReactNode;
+}>;
+export declare const LegacyPopover: React.FC<LegacyPopoverProps> & {
+    Header: typeof LegacyPopoverHeader;
+    Content: typeof LegacyPopoverContent;
+};
+export default LegacyPopover;

package/dist/components/primitives/Select/Select.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FC, SelectHTMLAttributes } from 'react';
+export interface SelectOption {
+    /**
+     * The value that will be submitted with the form
+     */
+    value: string;
+    /**
+     * The text that will be displayed in the select
+     */
+    label: string;
+}
+export interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'className'> {
+    /**
+     * Label text to display above the select
+     */
+    label?: string;
+    /**
+     * Error message to display below the select
+     */
+    error?: string;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    /**
+     * Whether the field is required
+     */
+    required?: boolean;
+    /**
+     * Whether the field is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Helper text to display below the select
+     */
+    helperText?: string;
+    /**
+     * The options to display in the select
+     */
+    options: SelectOption[];
+}
+declare const Select: FC<SelectProps>;
+export default Select;

package/dist/components/primitives/Spinner/Spinner.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FC, CSSProperties } from 'react';
+export type SpinnerSize = 'small' | 'medium' | 'large';
+export interface SpinnerProps {
+    /**
+     * Size of the spinner
+     */
+    size?: SpinnerSize;
+    /**
+     * Custom color for the spinner
+     */
+    color?: string;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    /**
+     * Custom styles
+     */
+    style?: CSSProperties;
+}
+/**
+ * Spinner component for loading states
+ *
+ * @example
+ * ```tsx
+ * // Basic spinner
+ * <Spinner />
+ *
+ * // Large spinner with custom color
+ * <Spinner size="large" color="#3b82f6" />
+ *
+ * // Small spinner
+ * <Spinner size="small" />
+ * ```
+ */
+declare const Spinner: FC<SpinnerProps>;
+export default Spinner;

package/dist/components/primitives/TextField/TextField.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FC, InputHTMLAttributes, ReactNode } from 'react';
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'className'> {
+    /**
+     * Label text to display above the input
+     */
+    label?: string;
+    /**
+     * Error message to display below the input
+     */
+    error?: string;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    /**
+     * Whether the field is required
+     */
+    required?: boolean;
+    /**
+     * Whether the field is disabled
+     */
+    disabled?: boolean;
+    /**
+     * Helper text to display below the input
+     */
+    helperText?: string;
+    /**
+     * Icon to display at the start (left) of the input
+     */
+    startIcon?: ReactNode;
+    /**
+     * Icon to display at the end (right) of the input
+     */
+    endIcon?: ReactNode;
+    /**
+     * Click handler for the start icon
+     */
+    onStartIconClick?: () => void;
+    /**
+     * Click handler for the end icon
+     */
+    onEndIconClick?: () => void;
+}
+declare const TextField: FC<TextFieldProps>;
+export default TextField;

package/dist/components/primitives/Typography/Typography.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { CSSProperties, FC, ReactNode, ElementType } from 'react';
+export type TypographyVariant = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'subtitle1' | 'subtitle2' | 'body1' | 'body2' | 'caption' | 'overline' | 'button';
+export type TypographyAlign = 'left' | 'center' | 'right' | 'justify';
+export type TypographyColor = 'primary' | 'secondary' | 'error' | 'success' | 'warning' | 'info' | 'textPrimary' | 'textSecondary' | 'inherit';
+export interface TypographyProps {
+    /**
+     * The content to be rendered
+     */
+    children: ReactNode;
+    /**
+     * The typography variant to apply
+     */
+    variant?: TypographyVariant;
+    /**
+     * The HTML element or React component to render
+     */
+    component?: ElementType;
+    /**
+     * Text alignment
+     */
+    align?: TypographyAlign;
+    /**
+     * Color variant
+     */
+    color?: TypographyColor;
+    /**
+     * Whether the text should be clipped with ellipsis when it overflows
+     */
+    noWrap?: boolean;
+    /**
+     * Additional CSS class names
+     */
+    className?: string;
+    /**
+     * Custom styles
+     */
+    style?: CSSProperties;
+    /**
+     * Whether the text should be displayed inline
+     */
+    inline?: boolean;
+    /**
+     * Custom font weight
+     */
+    fontWeight?: 'normal' | 'medium' | 'semibold' | 'bold' | number;
+    /**
+     * Custom font size (overrides variant sizing)
+     */
+    fontSize?: string | number;
+    /**
+     * Line height
+     */
+    lineHeight?: string | number;
+    /**
+     * Whether to disable gutters (margin bottom)
+     */
+    gutterBottom?: boolean;
+}
+/**
+ * Typography component for consistent text rendering throughout the application.
+ * Integrates with the theme system and provides semantic HTML elements.
+ */
+declare const Typography: FC<TypographyProps>;
+export default Typography;

package/dist/contexts/Asgardeo/AsgardeoContext.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { Context } from 'react';
+/**
+ * Props interface of {@link AsgardeoContext}
+ */
+export type AsgardeoContextProps = {
+    /**
+     * Flag indicating whether the SDK is working in the background.
+     */
+    isLoading: boolean;
+    /**
+     * Flag indicating whether the user is signed in or not.
+     */
+    isSignedIn: boolean;
+    /**
+     * Sign-in function to initiate the authentication process.
+     * @remark This is the programmatic version of the `SignInButton` component.
+     * TODO: Fix the types.
+     */
+    signIn: any;
+    /**
+     * Sign-out function to terminate the authentication session.
+     * @remark This is the programmatic version of the `SignOutButton` component.
+     * FIXME: Fix the types.
+     */
+    signOut: any;
+    /**
+     * Sign-up function to initiate the registration process.
+     * @remark This is the programmatic version of the `SignUpButton` component.
+     * FIXME: Fix the types.
+     */
+    signUp: any;
+    user: any;
+    baseUrl: string;
+    afterSignInUrl: string;
+};
+/**
+ * Context object for managing the Authentication flow builder core context.
+ */
+declare const AsgardeoContext: Context<AsgardeoContextProps | null>;
+export default AsgardeoContext;

package/dist/{esm/types/components/public-components.d.ts → contexts/Asgardeo/AsgardeoProvider.d.ts}

@@ -1,5 +1,5 @@
 /**
- * Copyright (c) 2024, WSO2 LLC. (https://www.wso2.com).
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
  *
  * WSO2 LLC. licenses this file to you under the Apache License,
  * Version 2.0 (the "License"); you may not use this file except
@@ -15,8 +15,11 @@
  * specific language governing permissions and limitations
  * under the License.
  */
-export { default as SignIn } from './SignIn/SignIn';
-export { default as SignedIn } from './SignedIn/SignedIn';
-export { default as SignedOut } from './SignedOut/SignedOut';
-export { default as SignInButton } from './SignInButton/SignInButton';
-export { default as SignOutButton } from './SignOutButton/SignOutButton';
+import { FC, PropsWithChildren } from 'react';
+import { AsgardeoReactConfig } from '../../models/config';
+/**
+ * Props interface of {@link AsgardeoProvider}
+ */
+export type AsgardeoProviderProps = AsgardeoReactConfig;
+declare const AsgardeoProvider: FC<PropsWithChildren<AsgardeoProviderProps>>;
+export default AsgardeoProvider;

package/dist/contexts/Asgardeo/useAsgardeo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { AsgardeoContextProps } from './AsgardeoContext';
+declare const useAsgardeo: () => AsgardeoContextProps;
+export default useAsgardeo;

package/dist/contexts/Flow/FlowContext.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+/**
+ * Types of authentication flows/steps that can be displayed.
+ */
+export type FlowStep = {
+    id: string;
+    type: 'signin' | 'signup' | 'organization-signin' | 'forgot-password' | 'reset-password' | 'verify-email' | 'mfa';
+    title: string;
+    subtitle?: string;
+    canGoBack?: boolean;
+    metadata?: Record<string, any>;
+} | null;
+/**
+ * Message types for displaying in authentication flows.
+ */
+export interface FlowMessage {
+    id?: string;
+    type: 'success' | 'error' | 'warning' | 'info';
+    message: string;
+    dismissible?: boolean;
+}
+/**
+ * Context value for managing authentication flow UI state.
+ */
+export interface FlowContextValue {
+    currentStep: FlowStep;
+    setCurrentStep: (step: FlowStep) => void;
+    title: string;
+    setTitle: (title: string) => void;
+    subtitle?: string;
+    setSubtitle: (subtitle?: string) => void;
+    messages: FlowMessage[];
+    addMessage: (message: FlowMessage) => void;
+    removeMessage: (messageId: string) => void;
+    clearMessages: () => void;
+    error: string | null;
+    setError: (error: string | null) => void;
+    isLoading: boolean;
+    setIsLoading: (loading: boolean) => void;
+    showBackButton: boolean;
+    setShowBackButton: (show: boolean) => void;
+    onGoBack?: () => void;
+    setOnGoBack: (callback?: () => void) => void;
+    reset: () => void;
+    navigateToFlow: (flowType: NonNullable<FlowStep>['type'], options?: {
+        title?: string;
+        subtitle?: string;
+        metadata?: Record<string, any>;
+    }) => void;
+}
+/**
+ * Context for managing authentication flow UI state.
+ * This context handles titles, messages, navigation, and loading states
+ * for authentication flows like SignIn, SignUp, organization signin, etc.
+ */
+declare const FlowContext: import("react").Context<FlowContextValue>;
+export default FlowContext;

package/dist/contexts/Flow/FlowProvider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FC, PropsWithChildren } from 'react';
+import { FlowStep } from './FlowContext';
+/**
+ * Props for the FlowProvider component.
+ */
+export interface FlowProviderProps {
+    /**
+     * Initial step to start with.
+     */
+    initialStep?: FlowStep;
+    /**
+     * Initial title.
+     */
+    initialTitle?: string;
+    /**
+     * Initial subtitle.
+     */
+    initialSubtitle?: string;
+    /**
+     * Callback when flow type changes.
+     */
+    onFlowChange?: (step: FlowStep) => void;
+}
+/**
+ * Provider component for flow context.
+ * Manages shared UI state for authentication flows including titles, messages, and navigation.
+ */
+declare const FlowProvider: FC<PropsWithChildren<FlowProviderProps>>;
+export default FlowProvider;

package/dist/contexts/Flow/useFlow.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you under the Apache License,
+ * Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+import { FlowContextValue } from './FlowContext';
+/**
+ * Hook to access the flow context.
+ * Must be used within a FlowProvider.
+ *
+ * @example
+ * ```tsx
+ * const MyAuthComponent = () => {
+ *   const { title, setTitle, addMessage, isLoading } = useFlow();
+ *
+ *   const handleSuccess = () => {
+ *     addMessage({
+ *       type: 'success',
+ *       message: 'Authentication successful!'
+ *     });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <h1>{title}</h1>
+ *       {isLoading && <p>Loading...</p>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @returns The flow context value
+ * @throws Error if used outside of FlowProvider
+ */
+declare const useFlow: () => FlowContextValue;
+export default useFlow;