gotrip-fx-transaction-form 1.0.235-dev → 1.0.237-dev

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gotrip-fx-transaction-form",
-  "version": "1.0.235-dev",
+  "version": "1.0.237-dev",
   "description": "FX Transaction Form ES6 module",
   "main": "index.js",
   "types": "types/index.d.ts",

package/types/components/Insurance/InsuranceDatePicker.d.ts

@@ -0,0 +1,9 @@
+import { default as DatePicker } from 'react-datepicker';
+export interface DatePickerInputProps {
+    value?: string;
+    onClick?: () => void;
+    placeholder?: string;
+}
+/** Shared date picker input with calendar icon. Use as customInput for react-datepicker. */
+export declare const DatePickerInput: import('react').ForwardRefExoticComponent<DatePickerInputProps & import('react').RefAttributes<HTMLInputElement>>;
+export { DatePicker };

package/types/components/Insurance/{FormElements.d.ts → shared/FormElements.d.ts}

@@ -1,8 +1,8 @@
 import { Control, FieldPath, FieldValues, RegisterOptions } from 'react-hook-form';
 import { IconDefinition } from '@fortawesome/fontawesome-svg-core';
-import { EDocumentType, DocumentScanResult } from '../../hooks/useDocumentScan';
+import { EDocumentType, DocumentScanResult } from '../../../hooks/useDocumentScan';
 export declare const FieldLabel: ({ label, tooltip }: {
-    label: string;
+    label: React.ReactNode;
     tooltip?: string;
 }) => import("react/jsx-runtime").JSX.Element;
 export declare const InfoBanner: ({ children }: {
@@ -33,7 +33,7 @@ export declare enum InputType {
 interface FormInputFieldProps<T extends FieldValues> {
     name: FieldPath<T>;
     control: Control<T>;
-    label: string;
+    label: React.ReactNode;
     required?: boolean;
     placeholder?: string;
     type?: InputType;
@@ -49,6 +49,16 @@ interface FormInputFieldProps<T extends FieldValues> {
     disabled?: boolean;
 }
 export declare function FormInputField<T extends FieldValues>({ name, control, label, required, placeholder, type, rules, leftIcon, rightIcon, showScanButton, documentType, onScanClick, onScanComplete, showValidationState, isValid, disabled, }: FormInputFieldProps<T>): import("react/jsx-runtime").JSX.Element;
+interface FormTextareaFieldProps<T extends FieldValues> {
+    name: FieldPath<T>;
+    control: Control<T>;
+    label: string;
+    required?: boolean;
+    placeholder?: string;
+    rules?: RegisterOptions<T>;
+    rows?: number;
+}
+export declare function FormTextareaField<T extends FieldValues>({ name, control, label, required, placeholder, rules, rows, }: FormTextareaFieldProps<T>): import("react/jsx-runtime").JSX.Element;
 interface CountryComboboxProps {
     options: {
         value: string;

package/types/components/Insurance/shared/InfoBlockCard.d.ts

@@ -0,0 +1,10 @@
+import { IconDefinition } from '@fortawesome/fontawesome-svg-core';
+import { ReactNode } from 'react';
+interface InfoBlockCardProps {
+    title: string;
+    icon?: IconDefinition;
+    onEdit?: () => void;
+    children: ReactNode;
+}
+export declare function InfoBlockCard({ title, icon, onEdit, children }: InfoBlockCardProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/Insurance/shared/InsuranceRadioGroup.d.ts

@@ -0,0 +1,14 @@
+interface InsuranceRadioGroupOption<T extends string> {
+    value: T;
+    label: string;
+}
+interface InsuranceRadioGroupProps<T extends string> {
+    value: T;
+    onValueChange: (value: T) => void;
+    options: InsuranceRadioGroupOption<T>[];
+    direction?: 'row' | 'column';
+    gap?: number;
+    disabled?: boolean;
+}
+export declare function InsuranceRadioGroup<T extends string>({ value, onValueChange, options, direction, gap, disabled, }: InsuranceRadioGroupProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/Insurance/shared/PaymentMethodSelector.d.ts

@@ -0,0 +1,8 @@
+import { EPaymentMethod } from '../../../types/enum';
+interface PaymentMethodSelectorProps {
+    value: EPaymentMethod;
+    onChange: (value: EPaymentMethod) => void;
+    showTopupBalance?: boolean;
+}
+export declare function PaymentMethodSelector({ value, onChange, showTopupBalance, }: PaymentMethodSelectorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/Insurance/shared/SimpleSelect.d.ts

@@ -0,0 +1,14 @@
+interface SimpleSelectOption<T> {
+    value: T;
+    label: string;
+}
+interface SimpleSelectProps<T> {
+    value: T;
+    onChange: (value: T) => void;
+    options: SimpleSelectOption<T>[];
+    placeholder?: string;
+    size?: 'sm' | 'md';
+    minWidth?: number;
+}
+export declare function SimpleSelect<T extends string | number>({ value, onChange, options, placeholder, size, minWidth, }: SimpleSelectProps<T>): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/Insurance/shared/StepFooter.d.ts

@@ -0,0 +1,8 @@
+interface StepFooterProps {
+    onBack: () => void;
+    onNext?: () => void;
+    nextLabel?: string;
+    nextDisabled?: boolean;
+}
+export declare function StepFooter({ onBack, onNext, nextLabel, nextDisabled, }: StepFooterProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/Insurance/shared/index.d.ts

@@ -0,0 +1,6 @@
+export { InsuranceRadioGroup } from './InsuranceRadioGroup';
+export { PaymentMethodSelector } from './PaymentMethodSelector';
+export { InfoBlockCard } from './InfoBlockCard';
+export { StepFooter } from './StepFooter';
+export { SimpleSelect } from './SimpleSelect';
+export { FieldLabel, InfoBanner, OptionCard, DateInput, InputType, FormInputField, FormTextareaField, CountryCombobox, ProvinceCombobox, WardCombobox, } from './FormElements';

package/types/components/Modal/MotorInsurancePaymentModal.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+interface MotorInsurancePaymentModalProps {
+    open: boolean;
+    onClose: () => void;
+    qrCodeUrl: string;
+    transactionPublicId?: string;
+    amount: number;
+    onSuccess?: () => void;
+}
+declare const MotorInsurancePaymentModal: React.FC<MotorInsurancePaymentModalProps>;
+export default MotorInsurancePaymentModal;

package/types/components/MotorInsurance/Bike/BikePremiumSummary.d.ts

@@ -0,0 +1,7 @@
+import { MotorPremiumSummary as MotorPremiumSummaryType } from '../motor-insurance.types';
+interface BikePremiumSummaryProps {
+    summary?: MotorPremiumSummaryType | null;
+    isLoading?: boolean;
+}
+export declare const BikePremiumSummary: ({ summary, isLoading }: BikePremiumSummaryProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Bike/BikeStepOneForm.d.ts

@@ -0,0 +1,10 @@
+import { MotorPlanFormValues, MotorPremiumSummary as MotorPremiumSummaryType } from '../motor-insurance.types';
+import { Control, UseFormSetValue } from 'react-hook-form';
+type BikeStepOneFormProps = {
+    control: Control<MotorPlanFormValues>;
+    setValue: UseFormSetValue<MotorPlanFormValues>;
+    premiumSummary?: MotorPremiumSummaryType | null;
+    isLoadingQuote?: boolean;
+};
+export declare const BikeStepOneForm: ({ control, setValue, premiumSummary, isLoadingQuote, }: BikeStepOneFormProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Bike/BikeStepThreePayment.d.ts

@@ -0,0 +1,17 @@
+import { EPaymentMethod } from '../../../types/enum';
+import { MotorPlanFormValues, MotorPremiumSummary, VehicleInfoFormValues } from '../motor-insurance.types';
+export interface BikeStepThreePaymentProps {
+    planValues: MotorPlanFormValues;
+    premiumSummary: MotorPremiumSummary | null;
+    vehicleInfo: VehicleInfoFormValues | null;
+    isLoading: boolean;
+    paymentMode: EPaymentMethod;
+    onPaymentModeChange: (mode: EPaymentMethod) => void;
+    isTermsAgreed: boolean;
+    onTermsAgreedChange: (agreed: boolean) => void;
+    onPayment: () => void;
+    isProcessing: boolean;
+    isGuest: boolean;
+    onBack: () => void;
+}
+export declare const BikeStepThreePayment: ({ planValues, premiumSummary, vehicleInfo, isLoading, paymentMode, onPaymentModeChange, isTermsAgreed, onTermsAgreedChange, onPayment, isProcessing, isGuest, onBack, }: BikeStepThreePaymentProps) => import("react/jsx-runtime").JSX.Element;

package/types/components/MotorInsurance/Bike/BikeStepTwoVehicleInfo.d.ts

@@ -0,0 +1,11 @@
+import { VehicleInfoFormValues, MotorPremiumSummary as MotorPremiumSummaryType } from '../motor-insurance.types';
+interface BikeStepTwoVehicleInfoProps {
+    initialValues?: Partial<VehicleInfoFormValues>;
+    premiumSummary?: MotorPremiumSummaryType | null;
+    isLoadingQuote?: boolean;
+    onSubmit: (values: VehicleInfoFormValues) => void;
+    onBack: () => void;
+    formRef?: (form: HTMLFormElement | null) => void;
+}
+export declare const BikeStepTwoVehicleInfo: ({ initialValues, premiumSummary, isLoadingQuote, onSubmit, formRef, }: BikeStepTwoVehicleInfoProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Bike/CreateBikeInsuranceForm.d.ts

@@ -0,0 +1,8 @@
+export interface CreateBikeInsuranceFormProps {
+    storageKey: string;
+    title?: string;
+    onBack?: () => void;
+    onSuccess?: (transactionData: unknown) => void;
+    scrollable?: boolean;
+}
+export declare const CreateBikeInsuranceForm: ({ storageKey, title, onBack, onSuccess, scrollable, }: CreateBikeInsuranceFormProps) => import("react/jsx-runtime").JSX.Element;

package/types/components/MotorInsurance/Bike/index.d.ts

@@ -0,0 +1,5 @@
+export { BikePremiumSummary } from './BikePremiumSummary';
+export { BikeStepOneForm } from './BikeStepOneForm';
+export { BikeStepTwoVehicleInfo } from './BikeStepTwoVehicleInfo';
+export { BikeStepThreePayment } from './BikeStepThreePayment';
+export { CreateBikeInsuranceForm } from './CreateBikeInsuranceForm';

package/types/components/MotorInsurance/Car/CarPremiumSummary.d.ts

@@ -0,0 +1,7 @@
+import { MotorPremiumSummary as MotorPremiumSummaryType } from '../motor-insurance.types';
+interface CarPremiumSummaryProps {
+    summary: MotorPremiumSummaryType | null | undefined;
+    isLoading?: boolean;
+}
+export declare const CarPremiumSummary: ({ summary, isLoading }: CarPremiumSummaryProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Car/CarStepFourPayment.d.ts

@@ -0,0 +1,21 @@
+import { EPaymentMethod } from '../../../types/enum';
+import { CarPlanFormValues, CarPremiumSummary, CarVehicleInfoFormValues } from '../motor-insurance.types';
+interface CarStepFourPaymentProps {
+    planValues: CarPlanFormValues;
+    premiumSummary: CarPremiumSummary | null;
+    vehicleInfo: CarVehicleInfoFormValues | null;
+    buyerCertificateInfo: CarVehicleInfoFormValues | null;
+    isLoading: boolean;
+    paymentMode: EPaymentMethod;
+    onPaymentModeChange: (mode: EPaymentMethod) => void;
+    isTermsAgreed: boolean;
+    onTermsAgreedChange: (agreed: boolean) => void;
+    onPayment: () => void;
+    isProcessing: boolean;
+    isGuest: boolean;
+    onBack: () => void;
+    getProviderLogoUrl: (providerCode?: string | null) => string | undefined;
+    getTermsAgreeHtml: (providerCode?: string | null) => string | undefined;
+}
+export declare const CarStepFourPayment: ({ planValues, premiumSummary, vehicleInfo, buyerCertificateInfo, isLoading, paymentMode, onPaymentModeChange, isTermsAgreed, onTermsAgreedChange, onPayment, isProcessing, isGuest, onBack, getProviderLogoUrl, getTermsAgreeHtml, }: CarStepFourPaymentProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Car/CarStepOneForm.d.ts

@@ -0,0 +1,8 @@
+import { Control, UseFormSetValue } from 'react-hook-form';
+import { CarPlanFormValues } from '../motor-insurance.types';
+interface CarStepOneFormProps {
+    control: Control<CarPlanFormValues>;
+    setValue: UseFormSetValue<CarPlanFormValues>;
+}
+export declare const CarStepOneForm: ({ control, setValue }: CarStepOneFormProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Car/CarStepThreeInfo.d.ts

@@ -0,0 +1,10 @@
+import { CarVehicleInfoFormValues, MotorPremiumSummary as MotorPremiumSummaryType } from '../motor-insurance.types';
+interface CarStepThreeInfoProps {
+    initialValues?: Partial<CarVehicleInfoFormValues>;
+    premiumSummary: MotorPremiumSummaryType | null;
+    isLoadingQuote?: boolean;
+    onSubmit: (values: CarVehicleInfoFormValues) => void;
+    formRef?: (form: HTMLFormElement | null) => void;
+}
+export declare const CarStepThreeInfo: ({ initialValues, premiumSummary, isLoadingQuote, onSubmit, formRef, }: CarStepThreeInfoProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Car/CarStepTwoPlan.d.ts

@@ -0,0 +1,10 @@
+import { Control, UseFormSetValue } from 'react-hook-form';
+import { CarPlanFormValues, CarPremiumSummary } from '../motor-insurance.types';
+interface CarStepTwoPlanProps {
+    control: Control<CarPlanFormValues>;
+    setValue: UseFormSetValue<CarPlanFormValues>;
+    premiumSummary: CarPremiumSummary | null;
+    isLoadingQuote?: boolean;
+}
+export declare const CarStepTwoPlan: ({ control, setValue, premiumSummary, isLoadingQuote, }: CarStepTwoPlanProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/types/components/MotorInsurance/Car/CreateCarInsuranceForm.d.ts

@@ -0,0 +1,8 @@
+export interface CreateCarInsuranceFormProps {
+    storageKey: string;
+    title?: string;
+    onBack?: () => void;
+    onSuccess?: (transactionData: unknown) => void;
+    scrollable?: boolean;
+}
+export declare const CreateCarInsuranceForm: ({ storageKey, title, onBack, onSuccess, scrollable, }: CreateCarInsuranceFormProps) => import("react/jsx-runtime").JSX.Element;

package/types/components/MotorInsurance/Car/car-form.constants.d.ts

@@ -0,0 +1,23 @@
+import { EVehicleTypeCode, EVehicleUsageType } from '../motor-insurance.types';
+/** Manufacturing year range: from this year to current year. */
+export declare const MANUFACTURING_YEAR_MIN = 2007;
+export declare const SEAT_COUNT_OPTIONS: readonly [4, 5, 7, 9, 16, 24, 45];
+/** Usage purpose options (mục đích sử dụng) – EVehicleUsageType. */
+export declare const USAGE_PURPOSE_OPTIONS: {
+    value: EVehicleUsageType;
+    label: string;
+}[];
+/** Vehicle type code options (loại vận chuyển đặc biệt) by purpose + usage. */
+export type VehicleTypeCodeOption = {
+    value: EVehicleTypeCode;
+    label: string;
+};
+export declare function getVehicleTypeCodeOptions(isCommercialUse: boolean, usagePurposeCode: EVehicleUsageType | null): VehicleTypeCodeOption[];
+/** Seat and load capacity bounds by usage + vehicle type (from business rules). */
+export type SeatLoadBounds = {
+    seatMin: number;
+    seatMax: number;
+    loadMin?: number;
+    loadMax?: number;
+};
+export declare function getSeatAndLoadBounds(usagePurposeCode: EVehicleUsageType | null, vehicleTypeCode: EVehicleTypeCode | null): SeatLoadBounds;

package/types/components/MotorInsurance/Car/index.d.ts

@@ -0,0 +1,6 @@
+export { CarPremiumSummary } from './CarPremiumSummary';
+export { CarStepOneForm } from './CarStepOneForm';
+export { CarStepTwoPlan } from './CarStepTwoPlan';
+export { CarStepThreeInfo } from './CarStepThreeInfo';
+export { CarStepFourPayment } from './CarStepFourPayment';
+export { CreateCarInsuranceForm } from './CreateCarInsuranceForm';

package/types/components/MotorInsurance/CreateMotorInsuranceTransactionForm.d.ts

@@ -0,0 +1,10 @@
+import { EMotorVehicleType } from './motor-insurance.types';
+export interface CreateMotorInsuranceTransactionFormProps {
+    vehicleType: EMotorVehicleType;
+    storageKey: string;
+    title?: string;
+    onBack?: () => void;
+    onSuccess?: (transactionData: unknown) => void;
+    scrollable?: boolean;
+}
+export declare const CreateMotorInsuranceTransactionForm: ({ vehicleType, storageKey, title, onBack, onSuccess, scrollable, }: CreateMotorInsuranceTransactionFormProps) => import("react/jsx-runtime").JSX.Element;

package/types/components/MotorInsurance/index.d.ts

@@ -0,0 +1,4 @@
+export { BikePremiumSummary, BikeStepOneForm, BikeStepTwoVehicleInfo, CreateBikeInsuranceForm, } from './Bike';
+export { CarPremiumSummary, CarStepOneForm, CreateCarInsuranceForm } from './Car';
+export { CreateMotorInsuranceTransactionForm } from './CreateMotorInsuranceTransactionForm';
+export * from './motor-insurance.types';

package/types/components/MotorInsurance/motor-insurance.types.d.ts

@@ -0,0 +1,322 @@
+import { Control, UseFormSetValue } from 'react-hook-form';
+import { EPaymentMethod } from '../../types/enum';
+export declare enum EMotorVehicleType {
+    BIKE = "bike",
+    CAR = "car"
+}
+export declare enum EBikeVehicleType {
+    UNDER_50CC = "under_50cc",
+    OVER_50CC = "over_50cc",
+    THREE_WHEEL = "three_wheel"
+}
+export declare enum EBikeEngineCategory {
+    BELOW_50CC = "BL50",
+    ABOVE_50CC = "AB50",
+    ELECTRIC = "ELEC",
+    THREE_WHEEL = "3WHL",
+    SIMILAR_MOTOR = "SIM"
+}
+/**
+ * Purpose code.
+ */
+export declare enum EPurposeTypeCode {
+    BUSINESS = "BUSINESS",
+    NON_BUSINESS = "NON_BUSINESS"
+}
+/**
+ * Vehicle usage type enum.
+ */
+export declare enum EVehicleUsageType {
+    PASSENGER = "PASSENGER",
+    CARGO = "CARGO",
+    PASSENGER_CARGO = "PASSENGER_CARGO",
+    SPECIAL_PURPOSE = "SPECIAL_PURPOSE"
+}
+/**
+ * High-level vehicle type enum.
+ */
+export declare enum EVehicleTypeCode {
+    PASSENGER_STANDARD = "PASSENGER_STANDARD",
+    DRIVING_TRAINING = "DRIVING_TRAINING",
+    TRACTOR_HEAD = "TRACTOR_HEAD",
+    AMBULANCE = "AMBULANCE",
+    MONEY_TRUCK = "MONEY_TRUCK",
+    TRACTOR = "TRACTOR",
+    OTHER_SPECIAL_CAR = "OTHER_SPECIAL_CAR",
+    TAXI = "TAXI",
+    BUS = "BUS",
+    CARGO_STANDARD = "CARGO_STANDARD"
+}
+export type EMotorProvider = 'PVI' | 'DBV' | 'BAO_MINH';
+export type MotorPlanFormValues = {
+    vehicleType: EBikeVehicleType;
+    durationYears: 1 | 2 | 3;
+    startDate: Date | null;
+    endDate: Date | null;
+    provider: EMotorProvider;
+    passengerAccidentEnabled: boolean;
+    passengerAccidentLevel: number;
+    passengerAccidentCount: number;
+};
+/**
+ * DTO for bike quote API (aligned with backend BikeQuoteRequest).
+ */
+export interface BikeQuoteRequestDto {
+    /** Coverage start date, format yyyy-MM-dd */
+    startDate: string;
+    /** Coverage end date, format yyyy-MM-dd */
+    endDate: string;
+    vehicleTypeCode: EBikeEngineCategory;
+    occupantAccidentSumInsured?: number;
+    insuredOccupantCount?: number;
+}
+/**
+ * DTO for bike quote response.
+ */
+export interface BikeQuoteResponseDto {
+    success: boolean;
+    totalPremium?: number;
+    mandatoryPremium?: number;
+    occupantAccidentPremium?: number;
+    error?: string;
+}
+/**
+ * DTO for creating bike policy/certificate (BikePolicyRequest).
+ */
+export interface BikePolicyRequestDto {
+    /** Start date, yyyy-MM-dd or dd/MM/yyyy depending on provider */
+    startDate: string;
+    endDate: string;
+    ownerName: string;
+    ownerAddress: string;
+    customerEmail: string;
+    phoneNumber?: string;
+    licensePlate: string;
+    engineNumber: string;
+    chassisNumber: string;
+    vehicleTypeCode: EBikeEngineCategory;
+    brand?: string;
+    manufacturingYear?: string;
+    occupantAccidentSumInsured?: number;
+    insuredOccupantCount?: number;
+    occupantAccidentPremium?: number;
+    totalPremium?: number;
+    paymentMode: EPaymentMethod;
+}
+/**
+ * DTO for bike policy response (BikePolicyResponse).
+ * Includes extra info used for displaying result / QR code.
+ */
+export interface BikePolicyResponseDto {
+    policyId?: number | string;
+    policyNumber?: string;
+    transactionPublicId?: string;
+    orderId?: number;
+    qrCodeUrl?: string;
+    totalAmount?: number;
+    status?: string;
+    error?: string;
+}
+export type VehicleInfoFormValues = {
+    ownerFullName: string;
+    ownerAddress: string;
+    ownerIdNumber: string;
+    hasLicensePlate: boolean;
+    licensePlate: string;
+    chassisNumber: string;
+    engineNumber: string;
+    certificatePhone: string;
+    certificateEmail: string;
+};
+/** Insurance owner type: individual or company */
+export declare enum EOwnerType {
+    INDIVIDUAL = "individual",
+    COMPANY = "company"
+}
+/**
+ * Vehicle info for car policies extends the shared motor vehicle info
+ * with optional car-only attributes that may be required by providers.
+ */
+export type CarVehicleInfoFormValues = VehicleInfoFormValues & {
+    /** Manufacturing year as string (for exact provider mapping if needed) */
+    manufacturingYearText?: string;
+    /** Years in use */
+    yearInUse?: number | null;
+    /** Owner type: individual (name, idNumber) or company (companyName, taxNumber) */
+    ownerType?: EOwnerType | string;
+    /** Company name (when ownerType is company) */
+    companyName?: string;
+    /** Company tax number (when ownerType is company) */
+    companyTaxNumber?: string;
+    /** Province/state ID for address */
+    stateId?: number | null;
+    /** Ward/commune ID for address */
+    wardId?: number | null;
+    /** Whether user wants hard copy certificate */
+    hardCopyEnabled?: boolean;
+    /** Address to receive hard copy certificate (when hardCopyEnabled is true) */
+    receiveAddress?: string;
+};
+/**
+ * Car-specific plan values used across the car motor insurance wizard.
+ *
+ * Step 1 captures vehicle configuration (manufacturing year, purpose, seats, ...),
+ * Step 2 adds provider + duration + effective dates, and optional passenger accident cover.
+ *
+ * These fields are intentionally generic so they can be mapped to different
+ * provider DTOs on the backend (purpose codes, special transport flags, etc.).
+ */
+export type CarPlanFormValues = {
+    /** Manufacturing year */
+    manufacturingYear: number | null;
+    /** Whether the car is used for commercial transport */
+    isCommercialUse: boolean;
+    /** Usage purpose code (from API) */
+    usagePurposeCode: EVehicleUsageType | null;
+    /** Vehicle type code – sub of purpose + usage (EVehicleTypeCode). */
+    vehicleTypeCode: EVehicleTypeCode | null;
+    /** Number of seats (1–45) */
+    seatCount: number | null;
+    /** Load capacity in tons; required when usage is cargo (Chở hàng) */
+    loadCapacity: number | null;
+    /** Insurance duration in years */
+    durationYears: 1 | 2 | 3;
+    /** Coverage start date */
+    startDate: Date | null;
+    /** Coverage end date */
+    endDate: Date | null;
+    /** Insurance provider */
+    provider: EMotorProvider;
+    /** Enable/disable passenger accident coverage */
+    passengerAccidentEnabled: boolean;
+    /** Passenger accident sum insured per person per accident */
+    passengerAccidentLevel: number;
+    /** Number of passengers covered for accident */
+    passengerAccidentCount: number;
+};
+export type MotorPremiumSummary = {
+    mandatoryPremium: number;
+    tndsPersonCompensation: number;
+    tndsPropertyCompensation: number;
+    passengerAccidentPremium: number;
+    passengerAccidentLevel: number;
+    passengerAccidentPeopleCount: number;
+    totalPremium: number;
+};
+/** Alias for readability when working with car flows. */
+export type CarPremiumSummary = MotorPremiumSummary;
+/**
+ * DTO for car quote API (aligned with backend MotorCreateQuoteRequestCar / TESTING_MOTOR_INSURANCE.md).
+ */
+export interface CarQuoteRequestDto {
+    /** Coverage start date, format yyyy-MM-dd */
+    startDate: string;
+    /** Coverage end date, format yyyy-MM-dd */
+    endDate: string;
+    purposeTypeCode: EPurposeTypeCode;
+    vehicleUsageType: EVehicleUsageType;
+    vehicleTypeCode: EVehicleTypeCode;
+    /** Number of seats */
+    numberOfSeats: number;
+    /** Load capacity in tons */
+    loadCapacity?: number;
+    /** Passenger accident sum insured */
+    occupantAccidentSumInsured?: number;
+    /** Number of passengers covered for accident */
+    insuredOccupantCount?: number;
+}
+/**
+ * DTO for car quote response (MotorCreateQuoteResponse).
+ */
+export interface CarQuoteResponseDto {
+    success: boolean;
+    totalPremium?: number;
+    mandatoryPremium?: number;
+    occupantAccidentPremium?: number;
+    vehicleTypeCode?: string;
+    error?: string;
+}
+/**
+ * DTO for creating car policy/certificate (aligned with MotorCreatePolicyRequestCar).
+ */
+export interface CarPolicyRequestDto {
+    totalPremium: number;
+    /** Coverage start date, format yyyy-MM-dd */
+    startDate: string;
+    /** Coverage end date, format yyyy-MM-dd */
+    endDate: string;
+    ownerName: string;
+    ownerAddress: string;
+    /** Contact/buyer name: ownerName (individual) or companyName (company) */
+    customerName: string;
+    customerAddress?: string;
+    ownerType?: EOwnerType | string;
+    ownerIdNumber?: string;
+    companyName?: string;
+    companyTaxNumber?: string;
+    hardCopyEnabled?: boolean;
+    receiveAddress?: string;
+    stateId?: number | null;
+    wardId?: number | null;
+    customerEmail: string;
+    phoneNumber?: string;
+    purposeTypeCode: EPurposeTypeCode;
+    vehicleUsageType: EVehicleUsageType;
+    vehicleTypeCode: EVehicleTypeCode;
+    numberOfSeats: number;
+    /** Load capacity in tons */
+    loadCapacity?: number;
+    licensePlate: string;
+    chassisNumber: string;
+    engineNumber: string;
+    mandatoryPremium: number;
+    occupantAccidentSumInsured?: number;
+    insuredOccupantCount?: number;
+    occupantAccidentPremium?: number;
+    manufacturingYear?: string;
+    yearInUse?: string;
+    brand?: string;
+    model?: string;
+    hideLicensePlate?: boolean;
+    hidePremium?: boolean;
+    paymentMode: EPaymentMethod;
+}
+/**
+ * DTO for car policy response (MotorCreatePolicyResponse).
+ */
+export interface CarPolicyResponseDto {
+    success?: boolean;
+    policyId?: number | string;
+    policyNumber?: string;
+    certificateUrl?: string;
+    transactionPublicId?: string;
+    qrCodeUrl?: string;
+    totalAmount?: number;
+    status?: string;
+    error?: string;
+}
+export declare const VEHICLE_TYPE_LABELS: Record<EBikeVehicleType, string>;
+export declare const BIKE_VEHICLE_TYPE_CODE_LABELS: Record<string, string>;
+export declare const getBikeVehicleTypeCodeLabel: (code?: string | null) => string;
+/** Car vehicle type code labels (loại vận chuyển đặc biệt) for display. */
+export declare const CAR_VEHICLE_TYPE_CODE_LABELS: Record<string, string>;
+export declare const getVehicleTypeLabel: (vehicleType?: string) => string;
+export declare const getPassengerAccidentLevelLabel: (value?: number | null) => string;
+/** Usage purpose (mục đích sử dụng) labels for display. */
+export declare const USAGE_PURPOSE_LABELS: Record<EVehicleUsageType, string>;
+export declare const getCarUsagePurposeLabel: (code?: string | null) => string;
+export declare const getCarVehicleTypeCodeLabel: (code?: string | null) => string;
+export declare const getOwnerTypeLabel: (ownerType?: string | null) => string;
+export declare const DURATION_LABELS: Record<1 | 1.5 | 2 | 2.5 | 3, string>;
+export declare const PASSENGER_ACCIDENT_LEVELS: {
+    value: number;
+    label: string;
+}[];
+export type MotorStepOneFormProps = {
+    control: Control<MotorPlanFormValues>;
+    setValue: UseFormSetValue<MotorPlanFormValues>;
+    premiumSummary?: MotorPremiumSummary;
+    onNext: () => void;
+    onBack?: () => void;
+    isStepReady: boolean;
+};