chore(oas): [19/n] improve oas schemas (#9317)

- Improve OAS schemas [19/n]
- docs-generator: combine `Date | string` type to just `Date`.

www/utils/generated/oas-output/schemas/OrderShippingMethodAdjustment.ts

@@ -1,8 +1,61 @@
 /**
  * @schema OrderShippingMethodAdjustment
  * type: object
- * description: The adjustment's adjustments.
+ * description: The shipping method adjustment's details.
  * x-schemaName: OrderShippingMethodAdjustment
+ * required:
+ *   - shipping_method
+ *   - shipping_method_id
+ *   - id
+ *   - amount
+ *   - order_id
+ *   - created_at
+ *   - updated_at
+ * properties:
+ *   shipping_method:
+ *     $ref: "#/components/schemas/OrderShippingMethod"
+ *   shipping_method_id:
+ *     type: string
+ *     title: shipping_method_id
+ *     description: The ID of the shipping method this adjustment is for.
+ *   id:
+ *     type: string
+ *     title: id
+ *     description: The adjustment's ID.
+ *   code:
+ *     type: string
+ *     title: code
+ *     description: The adjustment's code.
+ *   amount:
+ *     type: number
+ *     title: amount
+ *     description: The adjustment's amount.
+ *   order_id:
+ *     type: string
+ *     title: order_id
+ *     description: The ID of the associated order.
+ *   description:
+ *     type: string
+ *     title: description
+ *     description: The adjustment's description.
+ *   promotion_id:
+ *     type: string
+ *     title: promotion_id
+ *     description: The ID of the promotion this adjustment applies.
+ *   provider_id:
+ *     type: string
+ *     title: provider_id
+ *     description: The adjustment's provider ID.
+ *   created_at:
+ *     type: string
+ *     format: date-time
+ *     title: created_at
+ *     description: The date the adjustment was created.
+ *   updated_at:
+ *     type: string
+ *     format: date-time
+ *     title: updated_at
+ *     description: The date the adjustment was updated.
  * 
 */