fix: expose type for field's position (#14390)

Adds `FieldPosition = 'main' | 'sidebar'` and uses it in `FieldAdmin`
and `AdminClient,` replacing the previous `'sidebar'`-only type.

This is especially useful when overriding a plugin field's default
`position: 'sidebar'` back to `'main'`, which already worked at runtime
but failed type-checking.

Also updates the docs to list both options and exports `FieldPosition`
from the package index.

---------

Co-authored-by: Patrik Kozak <35232443+PatrikKozak@users.noreply.github.com>

Author: bratvanov

docs/fields/overview.mdx

@@ -620,7 +620,7 @@ The following options are available:
 | **`condition`**         | Programmatically show / hide fields based on other fields. [More details](#conditional-logic).                                                                                                                                   |
 | **`components`**        | All Field Components can be swapped out for [Custom Components](../custom-components/overview) that you define.                                                                                                                  |
 | **`description`**       | Helper text to display alongside the field to provide more information for the editor. [More details](#description).                                                                                                             |
-| **`position`**          | Specify if the field should be rendered in the sidebar by defining `position: 'sidebar'`.                                                                                                                                        |
+| **`position`**          | Use `'sidebar'` to render the field in the sidebar or `'main'` (default) to keep it in the main area.                                                                                                                            |
 | **`width`**             | Restrict the width of a field. You can pass any string-based value here, be it pixels, percentages, etc. This property is especially useful when fields are nested within a `Row` type where they can be organized horizontally. |
 | **`style`**             | [CSS Properties](https://developer.mozilla.org/en-US/docs/Web/CSS) to inject into the root element of the field.                                                                                                                 |
 | **`className`**         | Attach a [CSS class attribute](https://developer.mozilla.org/en-US/docs/Web/CSS/Class_selectors) to the root DOM element of a field.                                                                                             |

packages/payload/src/fields/config/types.ts

@@ -343,6 +343,8 @@ export type BlocksFilterOptions<TData = any> =
     ) => BlockSlugOrString | Promise<BlockSlugOrString | true> | true)
   | BlockSlugOrString
 
+export type FieldPosition = 'main' | 'sidebar'
+
 export type FieldAdmin = {
   className?: string
   components?: {
@@ -385,7 +387,7 @@ export type FieldAdmin = {
    */
   disableListFilter?: boolean
   hidden?: boolean
-  position?: 'sidebar'
+  position?: FieldPosition
   readOnly?: boolean
   style?: CSSProperties
   width?: CSSProperties['width']
@@ -414,7 +416,7 @@ export type AdminClient = {
    */
   disableListFilter?: boolean
   hidden?: boolean
-  position?: 'sidebar'
+  position?: FieldPosition
   readOnly?: boolean
   style?: { '--field-width'?: CSSProperties['width'] } & CSSProperties
   width?: CSSProperties['width']

packages/payload/src/index.ts

@@ -1570,6 +1570,7 @@ export type {
   FieldBaseClient,
   FieldHook,
   FieldHookArgs,
+  FieldPosition,
   FieldPresentationalOnly,
   FieldPresentationalOnlyClient,
   FieldTypes,