docs: create docs workspace (#5174)

* docs: migrate ui docs to docs universe

* created yarn workspace

* added eslint and tsconfig configurations

* fix eslint configurations

* fixed eslint configurations

* shared tailwind configurations

* added shared ui package

* added more shared components

* migrating more components

* made details components shared

* move InlineCode component

* moved InputText

* moved Loading component

* Moved Modal component

* moved Select components

* Moved Tooltip component

* moved Search components

* moved ColorMode provider

* Moved Notification components and providers

* used icons package

* use UI colors in api-reference

* moved Navbar component

* used Navbar and Search in UI docs

* added Feedback to UI docs

* general enhancements

* fix color mode

* added copy colors file from ui-preset

* added features and enhancements to UI docs

* move Sidebar component and provider

* general fixes and preparations for deployment

* update docusaurus version

* adjusted versions

* fix output directory

* remove rootDirectory property

* fix yarn.lock

* moved code component

* added vale for all docs MD and MDX

* fix tests

* fix vale error

* fix deployment errors

* change ignore commands

* add output directory

* fix docs test

* general fixes

* content fixes

* fix announcement script

* added changeset

* fix vale checks

* added nofilter option

* fix vale error

www/apps/api-reference/specs/admin/components/schemas/ClaimOrder.yaml

@@ -0,0 +1,157 @@
+title: Claim
+description: >-
+  A Claim represents a group of faulty or missing items. It consists of claim
+  items that refer to items in the original order that should be replaced or
+  refunded. It also includes details related to shipping and fulfillment.
+type: object
+required:
+  - canceled_at
+  - created_at
+  - deleted_at
+  - fulfillment_status
+  - id
+  - idempotency_key
+  - metadata
+  - no_notification
+  - order_id
+  - payment_status
+  - refund_amount
+  - shipping_address_id
+  - type
+  - updated_at
+properties:
+  id:
+    description: The claim's ID
+    type: string
+    example: claim_01G8ZH853Y6TFXWPG5EYE81X63
+  type:
+    description: The claim's type
+    type: string
+    enum:
+      - refund
+      - replace
+  payment_status:
+    description: The status of the claim's payment
+    type: string
+    enum:
+      - na
+      - not_refunded
+      - refunded
+    default: na
+  fulfillment_status:
+    description: The claim's fulfillment status
+    type: string
+    enum:
+      - not_fulfilled
+      - partially_fulfilled
+      - fulfilled
+      - partially_shipped
+      - shipped
+      - partially_returned
+      - returned
+      - canceled
+      - requires_action
+    default: not_fulfilled
+  claim_items:
+    description: The details of the items that should be replaced or refunded.
+    type: array
+    x-expandable: claim_items
+    items:
+      $ref: ./ClaimItem.yaml
+  additional_items:
+    description: >-
+      The details of the new items to be shipped when the claim's type is
+      `replace`
+    type: array
+    x-expandable: additional_items
+    items:
+      $ref: ./LineItem.yaml
+  order_id:
+    description: The ID of the order that the claim comes from.
+    type: string
+    example: order_01G8TJSYT9M6AVS5N4EMNFS1EK
+  order:
+    description: The details of the order that this claim was created for.
+    x-expandable: order
+    nullable: true
+    type: object
+  return_order:
+    description: >-
+      The details of the return associated with the claim if the claim's type is
+      `replace`.
+    x-expandable: return_order
+    nullable: true
+    type: object
+  shipping_address_id:
+    description: The ID of the address that the new items should be shipped to
+    nullable: true
+    type: string
+    example: addr_01G8ZH853YPY9B94857DY91YGW
+  shipping_address:
+    description: The details of the address that new items should be shipped to.
+    x-expandable: shipping_address
+    nullable: true
+    $ref: ./Address.yaml
+  shipping_methods:
+    description: >-
+      The details of the shipping methods that the claim order will be shipped
+      with.
+    type: array
+    x-expandable: shipping_methods
+    items:
+      $ref: ./ShippingMethod.yaml
+  fulfillments:
+    description: The fulfillments of the new items to be shipped
+    type: array
+    x-expandable: fulfillments
+    items:
+      type: object
+  refund_amount:
+    description: The amount that will be refunded in conjunction with the claim
+    nullable: true
+    type: integer
+    example: 1000
+  canceled_at:
+    description: The date with timezone at which the claim was canceled.
+    nullable: true
+    type: string
+    format: date-time
+  created_at:
+    description: The date with timezone at which the resource was created.
+    type: string
+    format: date-time
+  updated_at:
+    description: The date with timezone at which the resource was updated.
+    type: string
+    format: date-time
+  deleted_at:
+    description: The date with timezone at which the resource was deleted.
+    nullable: true
+    type: string
+    format: date-time
+  metadata:
+    description: An optional key-value map with additional details
+    nullable: true
+    type: object
+    example:
+      car: white
+    externalDocs:
+      description: Learn about the metadata attribute, and how to delete and update it.
+      url: >-
+        https://docs.medusajs.com/development/entities/overview#metadata-attribute
+  no_notification:
+    description: >-
+      Flag for describing whether or not notifications related to this should be
+      send.
+    nullable: true
+    type: boolean
+    example: false
+  idempotency_key:
+    description: >-
+      Randomly generated key used to continue the completion of the cart
+      associated with the claim in case of failure.
+    nullable: true
+    type: string
+    externalDocs:
+      url: https://docs.medusajs.com/development/idempotency-key/overview.md
+      description: Learn more how to use the idempotency key.