feat: enhance contract clearance process with linked booking details

- Added  and  to  for better visibility of GL-created shipment bookings.
- Implemented  method in  to fetch the latest clearance phase for contracts, improving list responses.
- Introduced  property in the  entity to store the latest clearance cycle's phase.
- Updated  to surface linked booking information in the clearance view.
- Created  component to display detailed container information in booking details.
- Refactored booking actions to remove contract-related actions from the booking request page.
- Enhanced the  component to reflect the current phase of clearance actions.
- Updated UI components to provide clearer messaging regarding the status of clearance and linked bookings.
- Adjusted action handling in  to include duty payment actions.
- Improved the  to show hints for each phase of the clearance process.

packages/types/src/freight/contracts.ts

@@ -356,6 +356,9 @@ export interface ContractClearanceView {
   /** Export post-booking clearance finalized after transit permit upload. */
   exportClearanceFinalized?: boolean;
   linkedBookingId?: string | null;
+  /** Reference + status of the GL-created shipment booking, once it exists. */
+  linkedBookingReference?: string | null;
+  linkedBookingStatus?: string | null;
   dutyAdvice?: {
     amount: number;
     currency: string;
@@ -577,6 +580,12 @@ export interface IContract extends BaseEntity {
   status: ContractStatus;
   clearanceStatus: ContractClearanceStatus;
   clearanceCycleNumber: number;
+  /**
+   * Latest clearance cycle's current phase (list responses only). Lets list
+   * consumers show step-accurate customer actions without fetching the full
+   * clearance view per contract.
+   */
+  clearancePhase?: ContractDocPhase | string | null;
 
   pricingBreakdown?: ContractPricingBreakdown | null;
   pricingDisplayMode?: "UNIT_RATES";