@cranberry-money/shared-types 8.17.13 → 8.17.15

package/dist/blueberry.d.ts

@@ -0,0 +1,1414 @@
+/**
+ * Blueberry-specific type definitions
+ * These interfaces are used in the Blueberry dashboard application
+ */
+import type { Portfolio, AssetAllocation as ImportedAssetAllocation, AssetHolding, Instrument, Trade, TargetTrade, WithdrawalRequest, WithdrawalAssetLiquidation, DashboardPerformanceData, WithdrawalSummary, BaseInstrumentFilters, CashAccount, SignupPayload, FormErrors, InvestmentPreferencePayload, MessageFieldValidation, UserProfile, TaxResidency, InvestmentPreference, Country, BaseFilters, DateRangeFilters, PortfolioTemplate, TargetAssetAllocation, UserProfilePayload, NavigationItem, TradeActionFilters, CashAccountTransaction, BadgeStyle, SimpleTradeStatus, SigninPayload, TaxResidencyPayload, WithdrawalAssetLiquidationPayload, TransactionFilters as ImportedTransactionFilters, InvestmentPreferenceFormState as ImportedInvestmentPreferenceFormState, InvestmentPreferenceFormValidation as ImportedInvestmentPreferenceFormValidation, TemplateWithAllocations as ImportedTemplateWithAllocations, RebalancingTradesGenerationResponse, Account, StockExchange, AssetHoldingSnapshot, CashAccountTransactionQueryParams as ImportedCashAccountTransactionQueryParams } from './index';
+import type { Sector } from './reference-data';
+import type { Industry } from './reference-data';
+import type { TimeRange, CashAccountTransactionType, CURRENCY_CODES } from '@cranberry-money/shared-constants';
+interface BaseFormValidation {
+    isFormValid: boolean;
+}
+interface BaseFieldValidation {
+    isValid: boolean;
+    isEmpty: boolean;
+}
+type CurrencyCode = typeof CURRENCY_CODES.AUD | typeof CURRENCY_CODES.USD;
+/**
+ * Asset allocation interface for portfolio templates
+ * Used for backward compatibility in portfolio template services
+ */
+export interface AssetAllocation {
+    instrument: {
+        symbol: string;
+        name: string;
+    };
+    percentage: string;
+}
+/**
+ * Simplified allocation state for the asset allocation page
+ */
+export interface AllocationState {
+    searchQuery: string;
+    selectedInstruments: Set<string>;
+    allocations: Record<string, number>;
+    showFilters: boolean;
+    filters: InstrumentFilters;
+}
+/**
+ * Instrument filters with asset allocation specific extension
+ */
+export interface InstrumentFilters extends BaseInstrumentFilters {
+    showAllocatedOnly?: boolean;
+}
+/**
+ * Available filter options derived from instruments
+ */
+export interface FilterOptions {
+    sectors: Sector[];
+    exchanges: StockExchange[];
+    industries: Industry[];
+    loadingSectors: boolean;
+    loadingExchanges?: boolean;
+    loadingIndustries?: boolean;
+}
+/**
+ * Chart data for allocation visualization
+ */
+export interface AllocationChartData {
+    instrumentUuid: string;
+    symbol: string;
+    name: string;
+    percentage: number;
+    color: string;
+}
+/**
+ * Hook return type for the main asset allocation hook
+ */
+export interface UseAssetAllocationReturn {
+    state: AllocationState;
+    instruments: Instrument[];
+    portfolio: Portfolio | null;
+    currentAllocations: ImportedAssetAllocation[];
+    chartData: AllocationChartData[];
+    filteredInstruments: Instrument[];
+    filterOptions: FilterOptions;
+    isValid: boolean;
+    isLoading: boolean;
+    isSaving: boolean;
+    setSearchQuery: (query: string) => void;
+    toggleInstrument: (instrumentUuid: string) => void;
+    updateAllocation: (instrumentUuid: string, percentage: number) => void;
+    updateFilters: (filters: Partial<InstrumentFilters>) => void;
+    applyFilters: () => void;
+    toggleFilters: () => void;
+    closeFilters: () => void;
+    clearFilters: () => void;
+    saveAllocations: () => Promise<void>;
+    resetAllocations: () => void;
+    handleBack: () => void;
+    handleSubmit: () => Promise<void>;
+}
+/**
+ * Dashboard view component props (generic to support different withdrawal types)
+ */
+export interface DashboardViewProps<TWithdrawalRequest = WithdrawalRequest, TWithdrawalAssetLiquidation = WithdrawalAssetLiquidation> {
+    portfolio: Portfolio | undefined;
+    allocations: ImportedAssetAllocation[];
+    holdings: AssetHolding[];
+    trades: Trade[];
+    targetTrades: TargetTrade[];
+    withdrawalRequests: TWithdrawalRequest[];
+    withdrawalLiquidations: TWithdrawalAssetLiquidation[];
+    withdrawalSummary: WithdrawalSummary<TWithdrawalAssetLiquidation>;
+    performanceData: DashboardPerformanceData | null;
+    totalCashBalance: number;
+    isLoading: boolean;
+    onRefresh?: () => void;
+    onRefreshTrades?: () => void;
+    onRefreshTargetTrades?: () => void;
+    onRefreshCashTransactions?: () => void;
+    onRefreshPortfolio?: () => void;
+    onRefreshAssets?: () => void;
+    onRefreshWithdrawals?: () => void;
+}
+/**
+ * Dashboard hook return type (generic to support different withdrawal types)
+ */
+export interface UseDashboardReturn<TWithdrawalRequest = WithdrawalRequest, TWithdrawalAssetLiquidation = WithdrawalAssetLiquidation> {
+    portfolio: Portfolio | undefined;
+    allocations: ImportedAssetAllocation[];
+    holdings: AssetHolding[];
+    trades: Trade[];
+    targetTrades: TargetTrade[];
+    withdrawalRequests: TWithdrawalRequest[];
+    withdrawalLiquidations: TWithdrawalAssetLiquidation[];
+    withdrawalSummary: WithdrawalSummary<TWithdrawalAssetLiquidation>;
+    performanceData: DashboardPerformanceData | null;
+    totalCashBalance: number;
+    isLoading: boolean;
+    isError: boolean;
+    error: Error | null;
+    onRetry: () => void;
+    onRefresh: () => void;
+    onRefreshTrades: () => void;
+    onRefreshTargetTrades: () => void;
+    onRefreshCashTransactions: () => void;
+    onRefreshPortfolio: () => void;
+    onRefreshAssets: () => void;
+    onRefreshWithdrawals: () => void;
+}
+/**
+ * Financial summary for target trades
+ */
+export interface FinancialSummary {
+    availableCashBalance: number;
+    estimatedBuyCost: number;
+    estimatedSellValue: number;
+    totalWithdrawalAmount: number;
+}
+/**
+ * Instrument holding information for target trades
+ */
+export interface InstrumentHolding {
+    instrumentUuid: string;
+    instrumentSymbol: string;
+    instrumentName: string;
+    currentPrice: number;
+    currentQuantity: number;
+    targetQuantity: number;
+}
+/**
+ * Cash transactions summary
+ */
+export interface CashSummary {
+    totalBalance: number;
+    totalDeposits: number;
+    totalWithdrawals: number;
+    netTransactionAmount: number;
+    transactionCount: number;
+    availableAccounts: CashAccount[];
+}
+/**
+ * Password validation state for signup forms
+ */
+export interface SignupPasswordValidation {
+    lengthValid: boolean;
+    notNumeric: boolean;
+}
+/**
+ * Props for the signup user form component
+ */
+export interface UserFormProps {
+    form: SignupPayload;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    showPassword: boolean;
+    passwordValidation: SignupPasswordValidation;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onTogglePassword: () => void;
+}
+/**
+ * Historical data point for portfolio performance
+ */
+export interface HistoricalDataPoint {
+    date: string;
+    price: string;
+    change: string;
+    changePercent: string;
+}
+/**
+ * Instrument performance data for portfolio visualization
+ */
+export interface InstrumentPerformanceData {
+    instrumentUuid: string;
+    symbol: string;
+    name: string;
+    percentage: string;
+    historicalData: HistoricalDataPoint[];
+    color: string;
+    isLoading: boolean;
+    isError: boolean;
+    error?: string;
+}
+/**
+ * Props for portfolio performance form
+ */
+export interface PortfolioPerformanceFormProps {
+    portfolio: Portfolio | null;
+    allocations: ImportedAssetAllocation[];
+    instrumentData: InstrumentPerformanceData[];
+    selectedTimeRange: TimeRange;
+    isLoading: boolean;
+    isError: boolean;
+    onTimeRangeChange: (range: TimeRange) => void;
+    onRetry: () => void;
+    onContinue: () => void;
+    onBack?: () => void;
+}
+/**
+ * Investment preference form state extending the payload
+ */
+export interface InvestmentPreferenceFormState extends InvestmentPreferencePayload {
+    userProfileId: string;
+}
+/**
+ * Form validation for investment preferences
+ */
+export interface InvestmentPreferenceFormValidation extends BaseFormValidation {
+    investmentHorizon: MessageFieldValidation;
+    riskTolerance: MessageFieldValidation;
+    investmentExperience: MessageFieldValidation;
+    investmentAmount: MessageFieldValidation;
+    sourceOfFunds: MessageFieldValidation;
+}
+/**
+ * Props for investment preferences form
+ */
+export interface InvestmentPreferenceFormProps {
+    form: InvestmentPreferenceFormState;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    existingPreferenceUuid: string | null;
+    formValidation?: InvestmentPreferenceFormValidation;
+    onChange: (field: keyof InvestmentPreferenceFormState, value: string | string[] | number) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onBack?: () => void;
+}
+/**
+ * Review data for signup completion
+ */
+export interface ReviewData {
+    userProfile: UserProfile | null;
+    taxResidencies: TaxResidency[];
+    investmentPreferences: InvestmentPreference | null;
+    portfolio: Portfolio | null;
+    allocations: ImportedAssetAllocation[];
+    countries: Country[];
+    citizenshipCountry: Country | null;
+}
+/**
+ * Props for review form component
+ */
+export interface ReviewFormProps<TDocumentType = string> {
+    data: ReviewData;
+    isLoading: boolean;
+    error: string | null;
+    termsAccepted: boolean;
+    onTermsChange: (accepted: boolean) => void;
+    onDocumentDownload: (type: TDocumentType) => void;
+    onCompleteSignup: () => void;
+    isSubmitting: boolean;
+    canCompleteSignup: boolean;
+    onBack?: () => void;
+}
+/**
+ * Return type for useReview hook
+ */
+export interface UseReviewReturn<TDocumentType = string> {
+    data: ReviewData;
+    isLoading: boolean;
+    error: string | null;
+    termsAccepted: boolean;
+    setTermsAccepted: (accepted: boolean) => void;
+    downloadDocument: (type: TDocumentType) => void;
+    completeSignup: () => void;
+    isSubmitting: boolean;
+    canCompleteSignup: boolean;
+}
+/**
+ * Props for the asset performance chart component (individual instruments)
+ */
+export interface AssetPerformanceChartProps {
+    instrumentData: InstrumentPerformanceData[];
+    selectedTimeRange: TimeRange;
+    isLoading: boolean;
+}
+/**
+ * Props for the portfolio performance chart component (aggregated portfolio)
+ */
+export interface PortfolioPerformanceChartProps {
+    allocations: ImportedAssetAllocation[];
+    instrumentData: InstrumentPerformanceData[];
+    selectedTimeRange: TimeRange;
+    isLoading: boolean;
+}
+/**
+ * Props for time range selector component
+ */
+export interface TimeRangeSelectorProps {
+    selectedRange: TimeRange;
+    onRangeChange: (range: TimeRange) => void;
+}
+/**
+ * Props for allocation summary component
+ */
+export interface AllocationSummaryProps {
+    allocations: ImportedAssetAllocation[];
+    instrumentData: InstrumentPerformanceData[];
+    isLoading: boolean;
+}
+/**
+ * Extended asset allocation with instrument details
+ */
+export interface AllocationWithInstrument extends ImportedAssetAllocation {
+    instrumentName: string;
+    instrumentSymbol: string;
+}
+/**
+ * Chart.js dataset for performance visualization
+ */
+export interface ChartDataset {
+    label: string;
+    data: {
+        x: string;
+        y: number;
+    }[];
+    borderColor: string;
+    backgroundColor: string;
+    fill: boolean;
+    tension: number;
+}
+interface NumericRangeFilters {
+    minValue?: number;
+    maxValue?: number;
+    [key: string]: unknown;
+}
+interface BaseSummaryPanelProps<T> {
+    readonly summary: T;
+    readonly isLoading?: boolean;
+    readonly error?: Error | null;
+    readonly onRefresh?: () => void;
+}
+interface BaseTradingPanelProps<TItem, TFilters> {
+    items: TItem[];
+    dialogFilters: TFilters;
+    clientSearchQuery: string;
+    isLoading?: boolean;
+    onSearch: (query: string) => void;
+    onUpdateDialogFilters: (filters: Partial<TFilters>) => void;
+    onApplyFiltersToServer: () => void;
+    onClearAllFilters: () => void;
+}
+/**
+ * Transaction filters for cash transactions page
+ */
+export interface TransactionFilters extends BaseFilters, DateRangeFilters, NumericRangeFilters {
+    transactionType?: unknown;
+}
+/**
+ * Trade filters interface
+ */
+export interface TradeFilters extends BaseFilters, DateRangeFilters, TradeActionFilters, NumericRangeFilters {
+    status?: SimpleTradeStatus;
+    settlementStartDate?: string;
+    settlementEndDate?: string;
+    currency?: string;
+}
+/**
+ * Cash summary panel props
+ */
+export interface CashSummaryPanelProps extends BaseSummaryPanelProps<CashSummary> {
+    cashSummary: CashSummary;
+    summary: CashSummary;
+}
+/**
+ * Transactions panel props
+ */
+export interface TransactionsPanelProps extends BaseTradingPanelProps<CashAccountTransaction, TransactionFilters> {
+    transactions: CashAccountTransaction[];
+    items: CashAccountTransaction[];
+    showFiltersDialog: boolean;
+    onOpenFiltersDialog: () => void;
+    onCloseFiltersDialog: () => void;
+}
+/**
+ * Target trade filters
+ */
+export interface TargetTradeFilters extends BaseFilters, DateRangeFilters, TradeActionFilters {
+    instrumentUuid?: string;
+}
+/**
+ * Tooltip component props
+ */
+export interface TooltipProps {
+    children: React.ReactNode;
+    content: string;
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    className?: string;
+    disabled?: boolean;
+    delay?: number;
+}
+/**
+ * Badge component props extending BadgeStyle
+ */
+export interface BadgeProps extends BadgeStyle {
+    children: React.ReactNode;
+    onClick?: () => void;
+}
+/**
+ * Layout component props
+ */
+export interface LayoutProps {
+    children: React.ReactNode;
+}
+/**
+ * Recent trades component props
+ */
+export interface RecentTradesProps {
+    trades: Trade[];
+    isLoading: boolean;
+    onRefresh?: () => void;
+}
+/**
+ * Target trades component props
+ */
+export interface TargetTradesProps {
+    targetTrades: TargetTrade[];
+    isLoading?: boolean;
+    onRefresh?: () => void;
+}
+/**
+ * Cash transactions component props
+ */
+export interface CashTransactionsProps {
+    cashAccountUuid?: string;
+    onRefresh?: () => void;
+}
+/**
+ * Portfolio summary card props
+ */
+export interface PortfolioSummaryCardProps {
+    portfolio: Portfolio | undefined;
+    performanceData: DashboardPerformanceData | null;
+    totalCashBalance: number;
+    onRefresh?: () => void;
+}
+/**
+ * Recent trade item props
+ */
+export interface RecentTradeItemProps {
+    trade: Trade;
+}
+/**
+ * Target trade item props
+ */
+export interface TargetTradeItemProps {
+    targetTrade: TargetTrade;
+}
+/**
+ * Withdrawal overview props
+ */
+export interface WithdrawalOverviewProps {
+    withdrawalRequests: WithdrawalRequest[];
+    withdrawalLiquidations: WithdrawalAssetLiquidation[];
+    withdrawalSummary: WithdrawalSummary;
+    isLoading: boolean;
+    onRefresh?: () => void;
+}
+/**
+ * Withdrawal request item props
+ */
+export interface WithdrawalRequestItemProps {
+    request: WithdrawalRequest;
+}
+/**
+ * Trades panel props
+ */
+export interface TradesPanelProps {
+    trades: Trade[];
+    dialogFilters: TradeFilters;
+    clientSearchQuery: string;
+    isLoading?: boolean;
+    onSearch: (query: string) => void;
+    onUpdateDialogFilters: (filters: Partial<TradeFilters>) => void;
+    onApplyFiltersToServer: () => void;
+    onClearAllFilters: () => void;
+}
+/**
+ * Trade item props
+ */
+export interface TradeItemProps {
+    trade: Trade;
+}
+/**
+ * Withdrawal liquidation item props
+ */
+export interface WithdrawalLiquidationItemProps {
+    liquidation: WithdrawalAssetLiquidation;
+}
+/**
+ * Radio group field props
+ */
+export interface RadioGroupFieldProps {
+    label: string;
+    value: string;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    error?: string[];
+    onChange: (value: string) => void;
+}
+/**
+ * Checkbox group field props
+ */
+export interface CheckboxGroupFieldProps {
+    label: string;
+    value: string[];
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+    error?: string[];
+    onChange: (values: string[]) => void;
+}
+/**
+ * Instrument data for allocation visualization
+ */
+export interface InstrumentData {
+    instrumentUuid: string;
+    symbol: string;
+    name: string;
+    percentage: string;
+    color: string;
+    isLoading: boolean;
+    isError: boolean;
+    historicalData: HistoricalDataPoint[];
+}
+/**
+ * Allocation bar props
+ */
+export interface AllocationBarProps {
+    instrumentData: InstrumentData[];
+}
+/**
+ * Loading state props
+ */
+export interface LoadingStateProps {
+    message?: string;
+    className?: string;
+}
+/**
+ * Error state props
+ */
+export interface ErrorStateProps {
+    title?: string;
+    message?: string;
+    retryLabel?: string;
+    onRetry: () => void;
+    className?: string;
+}
+/**
+ * Portfolio selection state
+ */
+export interface PortfolioSelectionState {
+    selectedTemplateUuid: string | null;
+    viewingDetailsForUuid: string | null;
+}
+/**
+ * Template with allocations type
+ */
+export interface TemplateWithAllocations {
+    template: PortfolioTemplate;
+    allocations?: TargetAssetAllocation[];
+    isLoading: boolean;
+    isError: boolean;
+}
+/**
+ * Portfolio selection form props
+ */
+export interface PortfolioSelectionFormProps {
+    templates: PortfolioTemplate[];
+    recommendedTemplateUuid: string | null;
+    selectedTemplateUuid: string | null;
+    viewingDetailsForUuid: string | null;
+    templateAllocations: Record<string, TemplateWithAllocations>;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    formValidation?: unknown;
+    onSelectTemplate: (templateUuid: string) => void;
+    onViewDetails: (templateUuid: string | null) => void;
+    onSubmit: () => void;
+    onCustomize: () => void;
+    onBack?: () => void;
+}
+/**
+ * User profile form props
+ */
+export interface UserProfileFormProps {
+    form: UserProfilePayload;
+    errors: FormErrors;
+    countries: Country[];
+    isSubmitting: boolean;
+    formValidation?: unknown;
+    onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onBack?: () => void;
+}
+/**
+ * Assets overview props
+ */
+export interface AssetsOverviewProps {
+    allocations: ImportedAssetAllocation[];
+    holdings: AssetHolding[];
+    isLoading?: boolean;
+    onRefresh?: () => void;
+}
+/**
+ * UseNavMenuReturn interface
+ */
+export interface UseNavMenuReturn<TIcon = unknown> {
+    navigationItems: NavigationItem<TIcon>[];
+    handleNavigation: (path: string) => void;
+    handleSignOut: () => void;
+    isSigningOut: boolean;
+    signOutError: Error | null;
+}
+/**
+ * Chart data for allocation visualization
+ */
+export interface AllocationChartData {
+    instrumentUuid: string;
+    symbol: string;
+    name: string;
+    percentage: number;
+    color: string;
+}
+/**
+ * Allocation chart props specific to asset allocation page
+ */
+export interface AllocationChartProps {
+    data: AllocationChartData[];
+    onPercentageChange?: (instrumentUuid: string, percentage: number) => void;
+    disableControls?: boolean;
+}
+/**
+ * Email confirmation payload
+ */
+export interface EmailConfirmationPayload {
+    token: string;
+}
+/**
+ * Token validation state
+ */
+export interface TokenValidation {
+    isValid: boolean;
+    isEmpty: boolean;
+    isValidFormat: boolean;
+}
+/**
+ * Email confirmation form props
+ */
+export interface EmailConfirmationFormProps {
+    form: EmailConfirmationPayload;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    isResending: boolean;
+    tokenValidation?: TokenValidation;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onResendCode: () => void;
+    onBack?: () => void;
+}
+/**
+ * Signin form props
+ */
+export interface SigninFormProps {
+    form: SigninPayload;
+    errors: FormErrors;
+    generalError: string | null;
+    isSubmitting: boolean;
+    showPassword: boolean;
+    onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onTogglePassword: () => void;
+}
+/**
+ * Tax residency form data
+ */
+export interface TaxResidencyForm extends TaxResidencyPayload {
+    localUuid: string;
+    backendUuid?: string;
+}
+/**
+ * Tax residency card props
+ */
+export interface TaxResidencyCardProps {
+    taxResidency: TaxResidencyForm;
+    index: number;
+    countries: Country[];
+    onChange: (index: number, field: keyof TaxResidencyForm, value: string | boolean | null) => void;
+    onRemove: (index: number) => void;
+    onTogglePrimary: (index: number) => void;
+    isOnlyOne: boolean;
+    errors: Record<string, string>;
+}
+/**
+ * Document UUIDs mapping
+ */
+export interface DocumentUUIDs {
+    [key: string]: string | null;
+}
+/**
+ * Portfolio selection form validation
+ */
+export interface PortfolioSelectionFormValidation extends BaseFormValidation {
+    selectedTemplate: MessageFieldValidation;
+}
+/**
+ * Allocation chart props for portfolio selection
+ */
+export interface PortfolioSelectionAllocationChartProps {
+    templateData: TemplateWithAllocations;
+}
+/**
+ * User profile form validation
+ */
+interface ExtendedFieldValidation extends BaseFieldValidation {
+    hasValidFormat: boolean;
+}
+interface DateFieldValidation extends BaseFieldValidation {
+    isValidDate: boolean;
+}
+interface AddressFieldValidation extends BaseFieldValidation {
+    isTooShort: boolean;
+}
+interface PhoneFieldValidation extends BaseFieldValidation {
+    hasValidFormat: boolean;
+}
+export interface UserProfileFormValidation extends BaseFormValidation {
+    fullName: ExtendedFieldValidation;
+    dateOfBirth: DateFieldValidation;
+    citizenshipCountry: BaseFieldValidation;
+    residentialAddress: AddressFieldValidation;
+    phoneNumber: PhoneFieldValidation;
+}
+/**
+ * Target trade item props
+ */
+export interface TargetTradeItemComponentProps {
+    trade: TargetTrade;
+}
+/**
+ * Document types available in the system
+ */
+export type BlueberryDocumentType = string;
+/**
+ * Bank account with specific account type
+ */
+interface BankAccount {
+    uuid: string;
+    account: string;
+    bankName: string;
+    branchName?: string;
+    accountNumber: string;
+    bsb: string;
+    accountName: string;
+    accountType: string;
+    currency: CurrencyCode;
+    swiftCode?: string;
+    iban?: string;
+    isVerified: boolean;
+    verificationDate?: string;
+    isPrimary: boolean;
+    isActive: boolean;
+    notes?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BankAccountQueryParams {
+    account?: string;
+    bankName?: string;
+    accountType?: string;
+    currency?: CurrencyCode;
+    isVerified?: boolean;
+    isPrimary?: boolean;
+    isActive?: boolean;
+    ordering?: string;
+}
+export interface BlueberryBankAccount extends Omit<BankAccount, 'accountType'> {
+    accountType: unknown;
+}
+/**
+ * Bank account query params with specific account type
+ */
+export interface BlueberryBankAccountQueryParams extends Omit<BankAccountQueryParams, 'accountType'> {
+    accountType?: unknown;
+}
+/**
+ * Withdrawal request with specific status type
+ */
+export interface BlueberryWithdrawalRequest extends Omit<WithdrawalRequest, 'status'> {
+    status: string;
+}
+/**
+ * Withdrawal asset liquidation with specific status type
+ */
+export interface BlueberryWithdrawalAssetLiquidation extends Omit<WithdrawalAssetLiquidation, 'liquidationStatus'> {
+    liquidationStatus: string;
+}
+/**
+ * Withdrawal asset liquidation payload with specific status type
+ */
+export interface BlueberryWithdrawalAssetLiquidationPayload extends Omit<WithdrawalAssetLiquidationPayload, 'liquidationStatus'> {
+    liquidationStatus?: string;
+}
+/**
+ * User document with string document type
+ */
+interface UserDocument {
+    uuid: string;
+    documentType: string;
+    createdAt: string;
+    status: string;
+    downloadUrl?: string;
+}
+interface GenerateDocumentPayload {
+    documentType: string;
+}
+interface DocumentQueryParams {
+    documentType?: string;
+    status?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface BlueberryUserDocument extends Omit<UserDocument, 'documentType'> {
+    documentType: string;
+}
+/**
+ * Generate document payload with specific document type
+ */
+export interface BlueberryGenerateDocumentPayload extends Omit<GenerateDocumentPayload, 'documentType'> {
+    documentType: BlueberryDocumentType;
+}
+/**
+ * Document query params with specific document type
+ */
+export interface BlueberryDocumentQueryParams extends Omit<DocumentQueryParams, 'documentType'> {
+    documentType?: BlueberryDocumentType;
+}
+/**
+ * Page-specific allocation state for asset allocation page
+ */
+export interface PageAllocationState {
+    searchQuery: string;
+    selectedInstruments: Set<string>;
+    allocations: Record<string, number>;
+    showFilters: boolean;
+    filters: InstrumentFilters;
+}
+/**
+ * Filter options for page components
+ */
+export interface PageFilterOptions {
+    sectors: Sector[];
+    exchanges: StockExchange[];
+    industries: Industry[];
+    loadingSectors: boolean;
+    loadingExchanges?: boolean;
+    loadingIndustries?: boolean;
+}
+/**
+ * Chart data for page allocation visualization
+ */
+export interface PageAllocationChartData {
+    instrumentUuid: string;
+    symbol: string;
+    name: string;
+    percentage: number;
+    color: string;
+}
+/**
+ * Asset allocation page hook return type
+ */
+export interface UsePageAssetAllocationReturn {
+    state: PageAllocationState;
+    instruments: Instrument[];
+    portfolio: Portfolio | null;
+    currentAllocations: ImportedAssetAllocation[];
+    chartData: PageAllocationChartData[];
+    filteredInstruments: Instrument[];
+    filterOptions: PageFilterOptions;
+    isValid: boolean;
+    isLoading: boolean;
+    isSaving: boolean;
+    setSearchQuery: (query: string) => void;
+    toggleInstrument: (instrumentUuid: string) => void;
+    updateAllocation: (instrumentUuid: string, percentage: number) => void;
+    updateFilters: (filters: Partial<InstrumentFilters>) => void;
+    applyFilters: () => void;
+    toggleFilters: () => void;
+    closeFilters: () => void;
+    clearFilters: () => void;
+    saveAllocations: () => Promise<void>;
+    resetAllocations: () => void;
+}
+/**
+ * Paginated tax residencies response
+ */
+export interface BlueberryPaginatedTaxResidencies {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: TaxResidency[];
+}
+/**
+ * Cash account transaction with specific transaction type
+ */
+export interface BlueberryCashAccountTransaction extends Omit<CashAccountTransaction, 'transactionType'> {
+    transactionType: unknown;
+}
+/**
+ * Transaction filters with specific transaction type
+ */
+export interface BlueberryTransactionFilters extends Omit<ImportedTransactionFilters, 'transactionType'> {
+    transactionType?: unknown;
+}
+/**
+ * Target trade filters with extended properties
+ */
+export interface BlueberryTargetTradeFilters extends TargetTradeFilters {
+    status?: string;
+    minValue?: number;
+    maxValue?: number;
+}
+/**
+ * Target trades management hook return type
+ */
+export interface UseTargetTradesManagementReturn {
+    financialSummary: FinancialSummary;
+    instruments: Instrument[];
+    holdings: InstrumentHolding[];
+    portfolioHoldings: InstrumentHolding[];
+    targetTrades: TargetTrade[];
+    sectors: Sector[];
+    exchanges: StockExchange[];
+    industries: Industry[];
+    dialogInstrumentFilters: InstrumentFilters;
+    serverInstrumentFilters: InstrumentFilters;
+    clientInstrumentSearchQuery: string;
+    showInstrumentFiltersDialog: boolean;
+    dialogTargetTradeFilters: BlueberryTargetTradeFilters;
+    serverTargetTradeFilters: BlueberryTargetTradeFilters;
+    clientTargetTradeSearchQuery: string;
+    showTargetTradeFiltersDialog: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    isSubmitting: boolean;
+    loadingSectors: boolean;
+    loadingExchanges: boolean;
+    loadingIndustries: boolean;
+    error: Error | null;
+    onInstrumentSearch: (query: string) => void;
+    onClearInstrumentSearch: () => void;
+    onUpdateDialogInstrumentFilters: (filters: Partial<InstrumentFilters>) => void;
+    onApplyInstrumentFiltersToServer: () => void;
+    onClearAllInstrumentFilters: () => void;
+    onToggleInstrumentFiltersDialog: () => void;
+    updateDialogInstrumentFilters: (filters: Partial<InstrumentFilters>) => void;
+    applyInstrumentFiltersToServer: () => void;
+    performClientInstrumentSearch: (query: string) => void;
+    clearClientInstrumentSearch: () => void;
+    clearAllInstrumentFilters: () => void;
+    toggleInstrumentFiltersDialog: () => void;
+    onTargetTradeSearch: (query: string) => void;
+    onClearTargetTradeSearch: () => void;
+    onUpdateDialogTargetTradeFilters: (filters: Partial<BlueberryTargetTradeFilters>) => void;
+    onApplyTargetFiltersToServer: () => void;
+    onClearAllTargetTradeFilters: () => void;
+    onToggleTargetTradeFiltersDialog: () => void;
+    updateDialogTargetTradeFilters: (filters: Partial<BlueberryTargetTradeFilters>) => void;
+    applyTargetFiltersToServer: () => void;
+    performClientTargetTradeSearch: (query: string) => void;
+    clearClientTargetTradeSearch: () => void;
+    clearAllTargetTradeFilters: () => void;
+    toggleTargetTradeFiltersDialog: () => void;
+    buyInstrument: (instrumentUuid: string) => Promise<void>;
+    sellInstrument: (instrumentUuid: string) => Promise<void>;
+    approveAllTrades: () => Promise<void>;
+    cleanAllTrades: () => Promise<void>;
+    generateRebalancingTrades: () => Promise<RebalancingTradesGenerationResponse>;
+    onRefresh: () => void;
+    refetch: () => void;
+}
+/**
+ * Investment preferences form props for component
+ */
+export interface BlueberryInvestmentPreferencesFormProps {
+    form: ImportedInvestmentPreferenceFormState;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    existingPreferenceUuid: string | null;
+    formValidation?: ImportedInvestmentPreferenceFormValidation;
+    onChange: (field: keyof ImportedInvestmentPreferenceFormState, value: string | string[] | number) => void;
+    onSubmit: (e: React.FormEvent) => void;
+    onBack?: () => void;
+}
+/**
+ * Portfolio selection form props for component
+ */
+export interface BlueberryPortfolioSelectionFormProps {
+    templates: PortfolioTemplate[];
+    recommendedTemplateUuid: string | null;
+    selectedTemplateUuid: string | null;
+    viewingDetailsForUuid: string | null;
+    templateAllocations: Record<string, ImportedTemplateWithAllocations>;
+    errors: FormErrors;
+    isSubmitting: boolean;
+    formValidation?: unknown;
+    onSelectTemplate: (templateUuid: string) => void;
+    onViewDetails: (templateUuid: string | null) => void;
+    onSubmit: () => void;
+    onCustomize: () => void;
+    onBack?: () => void;
+}
+/**
+ * Transaction filters for cash transactions page with specific transaction type
+ */
+export interface BlueberryPageTransactionFilters extends Omit<ImportedTransactionFilters, 'transactionType'> {
+    transactionType?: unknown;
+}
+/**
+ * Target trade filters for target trades page with extended properties
+ */
+export interface BlueberryPageTargetTradeFilters extends TargetTradeFilters {
+    status?: string;
+    minValue?: number;
+    maxValue?: number;
+}
+/**
+ * Rebalancing trades generation response with specific error types
+ */
+export interface BlueberryRebalancingTradesGenerationResponse extends Omit<RebalancingTradesGenerationResponse, 'errorType'> {
+    errorType?: unknown;
+}
+/**
+ * Paginated bank accounts response
+ */
+export interface BlueberryPaginatedBankAccounts {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: BlueberryBankAccount[];
+}
+/**
+ * Paginated countries response
+ */
+export interface BlueberryPaginatedCountries {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: Country[];
+}
+/**
+ * Paginated cash accounts response
+ */
+export interface BlueberryPaginatedCashAccounts {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: CashAccount[];
+}
+/**
+ * Paginated instruments response
+ */
+export interface BlueberryPaginatedInstruments {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: Instrument[];
+}
+/**
+ * Paginated sectors response
+ */
+export interface BlueberryPaginatedSectors {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: Sector[];
+}
+/**
+ * Paginated accounts response
+ */
+export interface BlueberryPaginatedAccounts {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: Account[];
+}
+/**
+ * Paginated stock exchanges response
+ */
+export interface BlueberryPaginatedStockExchanges {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: StockExchange[];
+}
+/**
+ * Paginated industries response
+ */
+export interface BlueberryPaginatedIndustries {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: Industry[];
+}
+/**
+ * Paginated asset holdings response
+ */
+export interface BlueberryPaginatedAssetHoldings {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: AssetHolding[];
+}
+/**
+ * Paginated asset holding snapshots response
+ */
+export interface BlueberryPaginatedAssetHoldingSnapshots {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: AssetHoldingSnapshot[];
+}
+/**
+ * Paginated withdrawal requests response
+ */
+export interface BlueberryPaginatedWithdrawalRequests {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: BlueberryWithdrawalRequest[];
+}
+/**
+ * Paginated withdrawal asset liquidations response
+ */
+export interface BlueberryPaginatedWithdrawalAssetLiquidations {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: BlueberryWithdrawalAssetLiquidation[];
+}
+/**
+ * Cash account transaction query parameters with specific transaction type
+ */
+export interface BlueberryCashAccountTransactionQueryParams extends Omit<ImportedCashAccountTransactionQueryParams, 'transactionType'> {
+    transactionType?: CashAccountTransactionType;
+}
+/**
+ * Instrument filters with asset allocation specific extension
+ */
+export interface BlueberryAssetAllocationInstrumentFilters extends BaseInstrumentFilters {
+    showAllocatedOnly?: boolean;
+}
+/**
+ * Enhanced allocation state with server filters
+ */
+export interface EnhancedAllocationState extends AllocationState {
+    serverFilters: InstrumentFilters;
+}
+/**
+ * Financial summary panel props
+ */
+export interface FinancialSummaryPanelProps {
+    financialSummary: FinancialSummary;
+    isLoading?: boolean;
+    error?: Error | null;
+    onRefresh?: () => void;
+}
+/**
+ * Search target trades field props
+ */
+export interface SearchTargetTradesFieldProps {
+    value: string;
+    onSearch: (query: string) => void;
+    onClear: () => void;
+    placeholder?: string;
+}
+/**
+ * Review allocation data structure for signup review
+ */
+export interface ReviewAllocation {
+    uuid: string;
+    instrumentName: string;
+    instrumentSymbol: string;
+    percentage: string;
+}
+/**
+ * Review allocation summary props
+ */
+export interface ReviewAllocationSummaryProps {
+    allocations: ReviewAllocation[];
+}
+/**
+ * Instruments panel props for target trades
+ */
+export interface InstrumentsPanelProps {
+    instruments: Instrument[];
+    holdings: InstrumentHolding[];
+    sectors: Sector[];
+    exchanges: StockExchange[];
+    industries: Industry[];
+    isLoading: boolean;
+    isSubmitting: boolean;
+    loadingSectors: boolean;
+    loadingExchanges: boolean;
+    loadingIndustries: boolean;
+    filters: InstrumentFilters;
+    showFiltersDialog: boolean;
+    onSearch: (query: string) => void;
+    onClear: () => void;
+    onUpdateFilters: (filters: Partial<InstrumentFilters>) => void;
+    onApplyFilters: () => void;
+    onClearFilters: () => void;
+    onToggleFiltersDialog: () => void;
+    onBuyInstrument: (instrumentUuid: string) => void;
+    onSellInstrument: (instrumentUuid: string) => void;
+    onRefresh?: () => void;
+}
+/**
+ * Instruments table props for asset allocation
+ */
+export interface AssetAllocationInstrumentsTableProps {
+    instruments: Instrument[];
+    selectedInstruments: Set<string>;
+    onToggleInstrument: (instrumentUuid: string) => void;
+    isLoading?: boolean;
+    isSubmitting?: boolean;
+}
+/**
+ * Target trades panel props
+ */
+export interface TargetTradesPanelProps {
+    targetTrades: TargetTrade[];
+    isLoading: boolean;
+    onRefresh?: () => void;
+    dialogTargetTradeFilters: TargetTradeFilters;
+    clientTargetTradeSearchQuery: string;
+    showTargetTradeFiltersDialog: boolean;
+    onTargetTradeSearch: (query: string) => void;
+    onClearTargetTradeSearch: () => void;
+    onUpdateDialogTargetTradeFilters: (filters: Partial<TargetTradeFilters>) => void;
+    onApplyTargetFiltersToServer: () => void;
+    onClearAllTargetTradeFilters: () => void;
+    onToggleTargetTradeFiltersDialog: () => void;
+}
+/**
+ * Search instruments field props
+ */
+export interface SearchInstrumentsFieldProps {
+    value: string;
+    onSearch: (query: string) => void;
+    onClear: () => void;
+    placeholder?: string;
+}
+/**
+ * Allocation bar props for signup portfolio performance
+ */
+export interface SignupAllocationBarProps {
+    instrumentData: InstrumentPerformanceData[];
+}
+/**
+ * Search trades field props
+ */
+export interface SearchTradesFieldProps {
+    initialValue?: string;
+    onSearch: (query: string) => void;
+    placeholder?: string;
+}
+/**
+ * Extended allocation state for signup allocation hooks
+ */
+export interface SignupExtendedAllocationState extends AllocationState {
+    serverFilters: InstrumentFilters;
+}
+/**
+ * Parameters for allocation data hook
+ */
+export interface UseAllocationDataParams {
+    portfolio: Portfolio | null;
+}
+/**
+ * Return type for allocation data hook
+ */
+export interface UseAllocationDataReturn {
+    state: AllocationState;
+    instruments: Instrument[];
+    filteredInstruments: Instrument[];
+    chartData: AllocationChartData[];
+    currentAllocations: ImportedAssetAllocation[];
+    totalAllocation: number;
+    isValid: boolean;
+    isLoading: boolean;
+    isSaving: boolean;
+    setSearchQuery: (query: string) => void;
+    toggleInstrument: (instrumentUuid: string) => void;
+    updateAllocation: (instrumentUuid: string, percentage: number) => void;
+    updateFilters: (filters: Partial<InstrumentFilters>) => void;
+    applyFilters: () => void;
+    toggleFilters: () => void;
+    closeFilters: () => void;
+    clearFilters: () => void;
+    saveAllocations: () => Promise<void>;
+    resetAllocations: () => void;
+}
+/**
+ * Return type for signup flow hook
+ */
+export interface UseSignupFlowReturn {
+    portfolio: Portfolio | null;
+    isLoading: boolean;
+    isSaving: boolean;
+    navigate: unknown;
+}
+/**
+ * Instruments table props for signup asset allocation
+ */
+export interface SignupInstrumentsTableProps {
+    instruments: Instrument[];
+    selectedInstruments: Set<string>;
+    onToggleInstrument: (instrumentUuid: string) => void;
+    isLoading?: boolean;
+    isSubmitting?: boolean;
+}
+/**
+ * Search field props for asset allocation page
+ */
+export interface AssetAllocationSearchFieldProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    showFilters: boolean;
+    filters: InstrumentFilters;
+    filterOptions: FilterOptions;
+    onToggleFilters: () => void;
+    onCloseFilters: () => void;
+    onUpdateFilters: (filters: Partial<InstrumentFilters>) => void;
+    onApplyFilters: () => void;
+    onClearFilters: () => void;
+}
+/**
+ * Allocation chart props for signup
+ */
+export interface SignupAllocationChartProps {
+    data: AllocationChartData[];
+    onPercentageChange?: (instrumentUuid: string, percentage: number) => void;
+    disableControls?: boolean;
+}
+/**
+ * Search field props for signup asset allocation
+ */
+export interface SignupAssetAllocationSearchFieldProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    showFilters: boolean;
+    filters: InstrumentFilters;
+    filterOptions: FilterOptions;
+    onToggleFilters: () => void;
+    onCloseFilters: () => void;
+    onUpdateFilters: (filters: Partial<InstrumentFilters>) => void;
+    onApplyFilters: () => void;
+    onClearFilters: () => void;
+}
+/**
+ * Portfolio performance panel props for signup
+ */
+export interface PortfolioPerformancePanelProps {
+    portfolio: Portfolio | null;
+    allocations: ImportedAssetAllocation[];
+    instrumentData: InstrumentPerformanceData[];
+    selectedTimeRange: TimeRange;
+    isLoading: boolean;
+    isError: boolean;
+    onTimeRangeChange: (timeRange: TimeRange) => void;
+    onRetry: () => void;
+    onContinue: () => void;
+    onBackToPortfolioSelection: () => void;
+    onBackToAssetAllocation: () => void;
+}
+export {};
+//# sourceMappingURL=blueberry.d.ts.map