regenerate types

.gitignore

@@ -3,7 +3,6 @@ package-lock.json
 dist
 /.idea/*
 !/.idea/runConfigurations
-/.idea/runConfigurations/_template*
 !/.idea/payload.iml
 
 # Custom actions

.vscode/launch.json

@@ -118,13 +118,6 @@
       "request": "launch",
       "type": "node-terminal"
     },
-    {
-      "command": "pnpm tsx --no-deprecation test/dev.ts folder-view",
-      "cwd": "${workspaceFolder}",
-      "name": "Run Dev Folder View",
-      "request": "launch",
-      "type": "node-terminal"
-    },
     {
       "command": "pnpm tsx --no-deprecation test/dev.ts localization",
       "cwd": "${workspaceFolder}",

docs/access-control/globals.mdx

@@ -39,7 +39,7 @@ const GlobalWithAccessControl: GlobalConfig = {
     update: ({ req: { user } }) => {...},
 
     // Version-enabled Globals only
-    readVersions: () => {...},
+    readVersion: () => {...},
   },
   // highlight-end
 }
@@ -64,7 +64,7 @@ If a Global supports [Versions](../versions/overview), the following additional
 
 Returns a boolean result or optionally a [query constraint](../queries/overview) which limits who can read this global based on its current properties.
 
-To add read Access Control to a [Global](../configuration/globals), use the `access` property in the [Global Config](../configuration/globals):
+To add read Access Control to a [Global](../configuration/globals), use the `read` property in the [Global Config](../configuration/globals):
 
 ```ts
 import { GlobalConfig } from 'payload'
@@ -72,7 +72,7 @@ import { GlobalConfig } from 'payload'
 const Header: GlobalConfig = {
   // ...
   // highlight-start
-  access: {
+  read: {
     read: ({ req: { user } }) => {
       return Boolean(user)
     },

docs/admin/preview.mdx

@@ -65,7 +65,7 @@ preview: (doc, { req }) => `${req.protocol}//${req.host}/${doc.slug}` // highlig
 
 The Preview feature can be used to achieve "Draft Preview". After clicking the preview button from the Admin Panel, you can enter into "draft mode" within your front-end application. This will allow you to adjust your page queries to include the `draft: true` param. When this param is present on the request, Payload will send back a draft document as opposed to a published one based on the document's `_status` field.
 
-To enter draft mode, the URL provided to the `preview` function can point to a custom endpoint in your front-end application that sets a cookie or session variable to indicate that draft mode is enabled. This is framework specific, so the mechanisms here vary from framework to framework although the underlying concept is the same.
+To enter draft mode, the URL provided to the `preview` function can point to a custom endpoint in your front-end application that sets a cookie or session variable to indicate that draft mode is enabled. This is framework specific, so the mechanisms here very from framework to framework although the underlying concept is the same.
 
 ### Next.js
 

docs/admin/react-hooks.mdx

@@ -605,7 +605,7 @@ return (
         textField: {
           initialValue: 'Updated text',
           valid: true,
-          value: 'Updated text',
+          value: 'Upddated text',
         },
       },
       // blockType: "yourBlockSlug",
@@ -875,7 +875,7 @@ Useful to retrieve info about the currently logged in user as well as methods fo
 | **`refreshCookie`**      | A method to trigger the silent refreshing of a user's auth token                        |
 | **`setToken`**           | Set the token of the user, to be decoded and used to reset the user and token in memory |
 | **`token`**              | The logged in user's token (useful for creating preview links, etc.)                    |
-| **`refreshPermissions`** | Load new permissions (useful when content that affects permissions has been changed)    |
+| **`refreshPermissions`** | Load new permissions (useful when content that effects permissions has been changed)    |
 | **`permissions`**        | The permissions of the current user                                                     |
 
 ```tsx
@@ -1143,7 +1143,7 @@ This is useful for scenarios where you need to trigger another fetch regardless
 
 Route transitions are useful in showing immediate visual feedback to the user when navigating between pages. This is especially useful on slow networks when navigating to data heavy or process intensive pages.
 
-By default, any instances of `Link` from `@payloadcms/ui` will trigger route transitions by default.
+By default, any instances of `Link` from `@payloadcms/ui` will trigger route transitions dy default.
 
 ```tsx
 import { Link } from '@payloadcms/ui'

docs/authentication/cookies.mdx

@@ -62,7 +62,7 @@ In this scenario, if your cookie was still valid, malicious-intent.com would be
 
 ### CSRF Prevention
 
-Define domains that you trust and are willing to accept Payload HTTP-only cookie based requests from. Use the `csrf` option on the base Payload Config to do this:
+Define domains that your trust and are willing to accept Payload HTTP-only cookie based requests from. Use the `csrf` option on the base Payload Config to do this:
 
 ```ts
 // payload.config.ts
@@ -102,8 +102,8 @@ If option 1 isn't possible, then you can get around this limitation by [configur
 
 ```
 SameSite: None // allows the cookie to cross domains
-Secure: true // ensures it's sent over HTTPS only
-HttpOnly: true // ensures it's not accessible via client side JavaScript
+Secure: true // ensures its sent over HTTPS only
+HttpOnly: true // ensures its not accessible via client side JavaScript
 ```
 
 Configuration example:

docs/authentication/email.mdx

@@ -71,7 +71,7 @@ export const Customers: CollectionConfig = {
 
 #### generateEmailSubject
 
-Similarly to the above `generateEmailHTML`, you can also customize the subject of the email. The function arguments are the same but you can only return a string - not HTML.
+Similarly to the above `generateEmailHTML`, you can also customize the subject of the email. The function argument are the same but you can only return a string - not HTML.
 
 ```ts
 import type { CollectionConfig } from 'payload'
@@ -178,7 +178,7 @@ The following arguments are passed to the `generateEmailHTML` function:
 
 #### generateEmailSubject
 
-Similarly to the above `generateEmailHTML`, you can also customize the subject of the email. The function arguments are the same but you can only return a string - not HTML.
+Similarly to the above `generateEmailHTML`, you can also customize the subject of the email. The function argument are the same but you can only return a string - not HTML.
 
 ```ts
 import type { CollectionConfig } from 'payload'

docs/authentication/jwt.mdx

@@ -38,7 +38,7 @@ const request = await fetch('http://localhost:3000', {
 
 ### Omitting The Token
 
-In some cases you may want to prevent the token from being returned from the auth operations. You can do that by setting `removeTokenFromResponses` to `true` like so:
+In some cases you may want to prevent the token from being returned from the auth operations. You can do that by setting `removeTokenFromResponse` to `true` like so:
 
 ```ts
 import type { CollectionConfig } from 'payload'
@@ -46,7 +46,7 @@ import type { CollectionConfig } from 'payload'
 export const UsersWithoutJWTs: CollectionConfig = {
   slug: 'users-without-jwts',
   auth: {
-    removeTokenFromResponses: true, // highlight-line
+    removeTokenFromResponse: true, // highlight-line
   },
 }
 ```

docs/authentication/operations.mdx

@@ -67,7 +67,7 @@ query {
 }
 ```
 
-Document access can also be queried on a collection/global basis. Access on a global can be queried like `http://localhost:3000/api/global-slug/access`, Collection document access can be queried like `http://localhost:3000/api/collection-slug/access/:id`.
+Document access can also be queried on a collection/global basis. Access on a global can queried like `http://localhost:3000/api/global-slug/access`, Collection document access can be queried like `http://localhost:3000/api/collection-slug/access/:id`.
 
 ## Me
 

docs/authentication/overview.mdx

@@ -71,7 +71,7 @@ export const Admins: CollectionConfig = {
 </Banner>
 
 <Banner type="warning">
-  **Note:** Auth-enabled Collections will be automatically injected with the
+  **Note:** Auth-enabled Collections with be automatically injected with the
   `hash`, `salt`, and `email` fields. [More
   details](../fields/overview#field-names).
 </Banner>

docs/authentication/token-data.mdx

@@ -8,7 +8,7 @@ keywords: authentication, config, configuration, documentation, Content Manageme
 
 During the lifecycle of a request you will be able to access the data you have configured to be stored in the JWT by accessing `req.user`. The user object is automatically appended to the request for you.
 
-### Defining Token Data
+### Definining Token Data
 
 You can specify what data gets encoded to the Cookie/JWT-Token by setting `saveToJWT` property on fields within your auth collection.
 

docs/configuration/collections.mdx

@@ -132,7 +132,6 @@ The following options are available:
 | `hideAPIURL`                 | Hides the "API URL" meta field while editing documents within this Collection.                                                                                                                                                                          |
 | `enableRichTextLink`         | The [Rich Text](../fields/rich-text) field features a `Link` element which allows for users to automatically reference related documents within their rich text. Set to `true` by default.                                                              |
 | `enableRichTextRelationship` | The [Rich Text](../fields/rich-text) field features a `Relationship` element which allows for users to automatically reference related documents within their rich text. Set to `true` by default.                                                      |
-| `folders`                    | A boolean to enable folders for a given collection. Defaults to `false`. [More details](../folders/overview).                                                                                                                                           |
 | `meta`                       | Page metadata overrides to apply to this Collection within the Admin Panel. [More details](../admin/metadata).                                                                                                                                          |
 | `preview`                    | Function to generate preview URLs within the Admin Panel that can point to your app. [More details](../admin/preview).                                                                                                                                  |
 | `livePreview`                | Enable real-time editing for instant visual feedback of your front-end application. [More details](../live-preview/overview).                                                                                                                           |
@@ -177,7 +176,7 @@ The following options are available:
 #### Edit View Options
 
 ```ts
-import type { CollectionConfig } from 'payload'
+import type { CollectionCOnfig } from 'payload'
 
 export const MyCollection: CollectionConfig = {
   // ...
@@ -275,7 +274,7 @@ You can also pass an object to the collection's `graphQL` property, which allows
 
 ## TypeScript
 
-You can import types from Payload to help make writing your Collection configs easier and type-safe. There are two main types that represent the Collection Config, `CollectionConfig` and `SanitizedCollectionConfig`.
+You can import types from Payload to help make writing your Collection configs easier and type-safe. There are two main types that represent the Collection Config, `CollectionConfig` and `SanitizeCollectionConfig`.
 
 The `CollectionConfig` type represents a raw Collection Config in its full form, where only the bare minimum properties are marked as required. The `SanitizedCollectionConfig` type represents a Collection Config after it has been fully sanitized. Generally, this is only used internally by Payload.
 

docs/configuration/globals.mdx

@@ -205,7 +205,7 @@ You can also pass an object to the global's `graphQL` property, which allows you
 
 ## TypeScript
 
-You can import types from Payload to help make writing your Global configs easier and type-safe. There are two main types that represent the Global Config, `GlobalConfig` and `SanitizedGlobalConfig`.
+You can import types from Payload to help make writing your Global configs easier and type-safe. There are two main types that represent the Global Config, `GlobalConfig` and `SanitizeGlobalConfig`.
 
 The `GlobalConfig` type represents a raw Global Config in its full form, where only the bare minimum properties are marked as required. The `SanitizedGlobalConfig` type represents a Global Config after it has been fully sanitized. Generally, this is only used internally by Payload.
 

docs/configuration/overview.mdx

@@ -84,7 +84,6 @@ The following options are available:
 | **`csrf`**                 | A whitelist array of URLs to allow Payload to accept cookies from. [More details](../authentication/cookies#csrf-attacks).                                                                     |
 | **`defaultDepth`**         | If a user does not specify `depth` while requesting a resource, this depth will be used. [More details](../queries/depth).                                                                     |
 | **`defaultMaxTextLength`** | The maximum allowed string length to be permitted application-wide. Helps to prevent malicious public document creation.                                                                       |
-| `folders`                  | An optional object to configure global folder settings. [More details](../folders/overview).                                                                                                   |
 | `queryPresets`             | An object that to configure Collection Query Presets. [More details](../query-presets/overview).                                                                                               |
 | **`maxDepth`**             | The maximum allowed depth to be permitted application-wide. This setting helps prevent against malicious queries. Defaults to `10`. [More details](../queries/depth).                          |
 | **`indexSortableFields`**  | Automatically index all sortable top-level fields in the database to improve sort performance and add database compatibility for Azure Cosmos and similar.                                     |
@@ -213,7 +212,7 @@ For more information about what we track, take a look at our [privacy policy](/p
 
 ## Cross-origin resource sharing (CORS)#cors
 
-Cross-origin resource sharing (CORS) can be configured with either a whitelist array of URLS to allow CORS requests from, a wildcard string (`*`) to accept incoming requests from any domain, or an object with the following properties:
+Cross-origin resource sharing (CORS) can be configured with either a whitelist array of URLS to allow CORS requests from, a wildcard string (`*`) to accept incoming requests from any domain, or a object with the following properties:
 
 | Option        | Description                                                                                                                             |
 | ------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
@@ -292,7 +291,7 @@ export const script = async (config: SanitizedConfig) => {
     collection: 'pages',
     data: { title: 'my title' },
   })
-  payload.logger.info('Successfully seeded!')
+  payload.logger.info('Succesffully seeded!')
   process.exit(0)
 }
 ```

docs/custom-components/document-views.mdx

@@ -59,7 +59,7 @@ _For details on how to build Custom Views, including all available props, see [B
 
 ### Document Root
 
-The Document Root is mounted on the top-level route for a Document. Setting this property will completely take over the entire Document View layout, including the title, [Document Tabs](#document-tabs), _and all other nested Document Views_ including the [Edit View](./edit-view), API View, etc.
+The Document Root is mounted on the top-level route for a Document. Setting this property will completely take over the entire Document View layout, including the title, [Document Tabs](#ocument-tabs), _and all other nested Document Views_ including the [Edit View](./edit-view), API View, etc.
 
 When setting a Document Root, you are responsible for rendering all necessary components and controls, as no document controls or tabs would be rendered. To replace only the Edit View precisely, use the `edit.default` key instead.
 

docs/custom-components/root-components.mdx

@@ -40,7 +40,7 @@ The following options are available:
 | `beforeDashboard` | An array of Custom Components to inject into the built-in Dashboard, _before_ the default dashboard contents. [More details](#beforedashboard).                          |
 | `beforeLogin`     | An array of Custom Components to inject into the built-in Login, _before_ the default login form. [More details](#beforelogin).                                          |
 | `beforeNavLinks`  | An array of Custom Components to inject into the built-in Nav, _before_ the links themselves. [More details](#beforenavlinks).                                           |
-| `graphics.Icon`   | The simplified logo used in contexts like the `Nav` component. [More details](#graphicsicon).                                                                            |
+| `graphics.Icon`   | The simplified logo used in contexts like the the `Nav` component. [More details](#graphicsicon).                                                                        |
 | `graphics.Logo`   | The full logo used in contexts like the `Login` view. [More details](#graphicslogo).                                                                                     |
 | `header`          | An array of Custom Components to be injected above the Payload header. [More details](#header).                                                                          |
 | `logout.Button`   | The button displayed in the sidebar that logs the user out. [More details](#logoutbutton).                                                                               |
@@ -345,7 +345,7 @@ export default function MyCustomIcon() {
 
 The `Logo` property is the full logo used in contexts like the `Login` view. This is typically a larger, more detailed representation of your brand.
 
-To add a custom logo, use the `admin.components.graphics.Logo` property in your Payload Config:
+To add a custom logo, use the `admin.components.graphic.Logo` property in your Payload Config:
 
 ```ts
 import { buildConfig } from 'payload'

docs/database/postgres.mdx

@@ -39,7 +39,7 @@ export default buildConfig({
 import { vercelPostgresAdapter } from '@payloadcms/db-vercel-postgres'
 
 export default buildConfig({
-  // Automatically uses process.env.POSTGRES_URL if no options are provided.
+  // Automatically uses proces.env.POSTGRES_URL if no options are provided.
   db: vercelPostgresAdapter(),
   // Optionally, can accept the same options as the @vercel/postgres package.
   db: vercelPostgresAdapter({
@@ -224,7 +224,7 @@ Make sure Payload doesn't overlap table names with its collections. For example,
 ### afterSchemaInit
 
 Runs after the Drizzle schema is built. You can use this hook to modify the schema with features that aren't supported by Payload, or if you want to add a column that you don't want to be in the Payload config.
-To extend a table, Payload exposes `extendTable` utility to the args. You can refer to the [Drizzle documentation](https://orm.drizzle.team/docs/sql-schema-declaration).
+To extend a table, Payload exposes `extendTable` utillity to the args. You can refer to the [Drizzle documentation](https://orm.drizzle.team/docs/sql-schema-declaration).
 The following example adds the `extra_integer_column` column and a composite index on `country` and `city` columns.
 
 ```ts

docs/database/sqlite.mdx

@@ -189,7 +189,7 @@ Make sure Payload doesn't overlap table names with its collections. For example,
 ### afterSchemaInit
 
 Runs after the Drizzle schema is built. You can use this hook to modify the schema with features that aren't supported by Payload, or if you want to add a column that you don't want to be in the Payload config.
-To extend a table, Payload exposes `extendTable` utility to the args. You can refer to the [Drizzle documentation](https://orm.drizzle.team/docs/sql-schema-declaration).
+To extend a table, Payload exposes `extendTable` utillity to the args. You can refer to the [Drizzle documentation](https://orm.drizzle.team/docs/sql-schema-declaration).
 The following example adds the `extra_integer_column` column and a composite index on `country` and `city` columns.
 
 ```ts

docs/fields/array.mdx

@@ -80,7 +80,7 @@ export const MyArrayField: Field = {
 }
 ```
 
-The Array Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Array Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option                    | Description                                                                         |
 | ------------------------- | ----------------------------------------------------------------------------------- |

docs/fields/blocks.mdx

@@ -78,7 +78,7 @@ export const MyBlocksField: Field = {
 }
 ```
 
-The Blocks Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Blocks Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option                 | Description                                                                |
 | ---------------------- | -------------------------------------------------------------------------- |

docs/fields/code.mdx

@@ -68,7 +68,7 @@ export const MyCodeField: Field = {
 }
 ```
 
-The Code Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Code Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option              | Description                                                                                                                                                                     |
 | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

docs/fields/collapsible.mdx

@@ -58,7 +58,7 @@ export const MyCollapsibleField: Field = {
 }
 ```
 
-The Collapsible Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Collapsible Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option              | Description                     |
 | ------------------- | ------------------------------- |

docs/fields/date.mdx

@@ -65,7 +65,7 @@ export const MyDateField: Field = {
 }
 ```
 
-The Date Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Date Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property                       | Description                                                                                                                            |
 | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |

docs/fields/email.mdx

@@ -65,7 +65,7 @@ export const MyEmailField: Field = {
 }
 ```
 
-The Email Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Email Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property           | Description                                                               |
 | ------------------ | ------------------------------------------------------------------------- |

docs/fields/group.mdx

@@ -69,7 +69,7 @@ export const MyGroupField: Field = {
 }
 ```
 
-The Group Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Group Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option           | Description                                                                                                                                                                                                                                      |
 | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

docs/fields/json.mdx

@@ -67,7 +67,7 @@ export const MyJSONField: Field = {
 }
 ```
 
-The JSON Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The JSON Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option              | Description                                                                                                                                                   |
 | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |

docs/fields/number.mdx

@@ -70,7 +70,7 @@ export const MyNumberField: Field = {
 }
 ```
 
-The Number Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Number Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property           | Description                                                                       |
 | ------------------ | --------------------------------------------------------------------------------- |

docs/fields/overview.mdx

@@ -100,7 +100,7 @@ Here are the available Presentational Fields:
 
 ### Virtual Fields
 
-Virtual fields are used to display data that is not stored in the database. They are useful for displaying computed values that populate within the API response through hooks, etc.
+Virtual fields are used to display data that is not stored in the database. They are useful for displaying computed values that populate within the APi response through hooks, etc.
 
 Here are the available Virtual Fields:
 

docs/fields/radio.mdx

@@ -36,7 +36,7 @@ export const MyRadioField: Field = {
 | Option                 | Description                                                                                                                                                                                                                                                                                             |
 | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | **`name`** \*          | To be used as the property name when stored and retrieved from the database. [More](/docs/fields/overview#field-names)                                                                                                                                                                                  |
-| **`options`** \*       | Array of options to allow the field to store. Can either be an array of strings, or an array of objects containing a `label` string and a `value` string.                                                                                                                                               |
+| **`options`** \*       | Array of options to allow the field to store. Can either be an array of strings, or an array of objects containing an `label` string and a `value` string.                                                                                                                                              |
 | **`label`**            | Text used as a field label in the Admin Panel or an object with keys for each language.                                                                                                                                                                                                                 |
 | **`validate`**         | Provide a custom validation function that will be executed on both the Admin Panel and the backend. [More](/docs/fields/overview#validation)                                                                                                                                                            |
 | **`index`**            | Build an [index](/docs/database/overview) for this field to produce faster queries. Set this field to `true` if your users will perform queries on this field's data often.                                                                                                                             |
@@ -82,7 +82,7 @@ export const MyRadioField: Field = {
 }
 ```
 
-The Radio Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Radio Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property     | Description                                                                                                                  |
 | ------------ | ---------------------------------------------------------------------------------------------------------------------------- |

docs/fields/relationship.mdx

@@ -86,7 +86,7 @@ export const MyRelationshipField: Field = {
 }
 ```
 
-The Relationship Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Relationship Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property          | Description                                                                                                                                 |
 | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |

docs/fields/select.mdx

@@ -54,7 +54,6 @@ export const MySelectField: Field = {
 | **`enumName`**         | Custom enum name for this field when using SQL Database Adapter ([Postgres](/docs/database/postgres)). Auto-generated from name if not defined.                                                                                                                                                         |
 | **`dbName`**           | Custom table name (if `hasMany` set to `true`) for this field when using SQL Database Adapter ([Postgres](/docs/database/postgres)). Auto-generated from name if not defined.                                                                                                                           |
 | **`interfaceName`**    | Create a top level, reusable [Typescript interface](/docs/typescript/generating-types#custom-field-interfaces) & [GraphQL type](/docs/graphql/graphql-schema#custom-field-schemas).                                                                                                                     |
-| **`filterOptions`**    | Dynamically filter which options are available based on the user, data, etc. [More details](#filterOptions)                                                                                                                                                                                             |
 | **`typescriptSchema`** | Override field type generation with providing a JSON schema                                                                                                                                                                                                                                             |
 | **`virtual`**          | Provide `true` to disable field in the database, or provide a string path to [link the field with a relationship](/docs/fields/relationship#linking-virtual-fields-with-relationships). See [Virtual Fields](https://payloadcms.com/blog/learn-how-virtual-fields-can-help-solve-common-cms-challenges) |
 
@@ -68,61 +67,6 @@ _\* An asterisk denotes that a property is required._
   used as a GraphQL enum.
 </Banner>
 
-### filterOptions
-
-Used to dynamically filter which options are available based on the user, data, etc.
-
-Some examples of this might include:
-
-- Restricting options based on a user's role, e.g. admin-only options
-- Displaying different options based on the value of another field, e.g. a city/state selector
-
-The result of `filterOptions` will determine:
-
-- Which options are displayed in the Admin Panel
-- Which options can be saved to the database
-
-To do this, use the `filterOptions` property in your [Field Config](./overview):
-
-```ts
-import type { Field } from 'payload'
-
-export const MySelectField: Field = {
-  // ...
-  // highlight-start
-  type: 'select',
-  options: [
-    {
-      label: 'One',
-      value: 'one',
-    },
-    {
-      label: 'Two',
-      value: 'two',
-    },
-    {
-      label: 'Three',
-      value: 'three',
-    },
-  ],
-  filterOptions: ({ options, data }) =>
-    data.disallowOption1
-      ? options.filter(
-          (option) =>
-            (typeof option === 'string' ? options : option.value) !== 'one',
-        )
-      : options,
-  // highlight-end
-}
-```
-
-<Banner type="warning">
-  **Note:** This property is similar to `filterOptions` in
-  [Relationship](./relationship) or [Upload](./upload) fields, except that the
-  return value of this function is simply an array of options, not a query
-  constraint.
-</Banner>
-
 ## Admin Options
 
 To customize the appearance and behavior of the Select Field in the [Admin Panel](../admin/overview), you can use the `admin` option:
@@ -139,7 +83,7 @@ export const MySelectField: Field = {
 }
 ```
 
-The Select Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Select Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Property          | Description                                                                                                                                 |
 | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |

docs/fields/text.mdx

@@ -70,7 +70,7 @@ export const MyTextField: Field = {
 }
 ```
 
-The Text Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Text Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option             | Description                                                                                                                 |
 | ------------------ | --------------------------------------------------------------------------------------------------------------------------- |

docs/fields/textarea.mdx

@@ -67,7 +67,7 @@ export const MyTextareaField: Field = {
 }
 ```
 
-The Textarea Field inherits all of the default admin options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
+The Textarea Field inherits all of the default options from the base [Field Admin Config](./overview#admin-options), plus the following additional options:
 
 | Option             | Description                                                                                                                 |
 | ------------------ | --------------------------------------------------------------------------------------------------------------------------- |

docs/folders/overview.mdx

@@ -1,103 +0,0 @@
----
-title: Folders
-label: Overview
-order: 10
-desc: Folders allow you to group documents across collections, and are a great way to organize your content.
-keywords: folders, folder, content organization
----
-
-Folders allow you to group documents across collections, and are a great way to organize your content. Folders are built on top of relationship fields, when you enable folders on a collection, Payload adds a hidden relationship field `folders`, that relates to a folder — or no folder. Folders also have the `folder` field, allowing folders to be nested within other folders.
-
-The configuration for folders is done in two places, the collection config and the Payload config. The collection config is where you enable folders, and the Payload config is where you configure the global folder settings.
-
-<Banner type="warning">
-  **Note:** The Folders feature is currently in beta and may be subject to
-  change in minor versions updates prior to being stable.
-</Banner>
-
-## Folder Configuration
-
-On the payload config, you can configure the following settings under the `folders` property:
-
-```ts
-// Type definition
-
-type RootFoldersConfiguration = {
-  /**
-   * An array of functions to be ran when the folder collection is initialized
-   * This allows plugins to modify the collection configuration
-   */
-  collectionOverrides?: (({
-    collection,
-  }: {
-    collection: CollectionConfig
-  }) => CollectionConfig | Promise<CollectionConfig>)[]
-  /**
-   * Ability to view hidden fields and collections related to folders
-   *
-   * @default false
-   */
-  debug?: boolean
-  /**
-   * The Folder field name
-   *
-   * @default "folder"
-   */
-  fieldName?: string
-  /**
-   * Slug for the folder collection
-   *
-   * @default "payload-folders"
-   */
-  slug?: string
-}
-```
-
-```ts
-// Example usage
-
-import { buildConfig } from 'payload'
-
-const config = buildConfig({
-  // ...
-  folders: {
-    // highlight-start
-    debug: true, // optional
-    collectionOverrides: [
-      async ({ collection }) => {
-        return collection
-      },
-    ], // optional
-    fieldName: 'folder', // optional
-    slug: 'payload-folders', // optional
-    // highlight-end
-  },
-})
-```
-
-## Collection Configuration
-
-To enable folders on a collection, you need to set the `admin.folders` property to `true` on the collection config. This will add a hidden relationship field to the collection that relates to a folder — or no folder.
-
-```ts
-// Type definition
-
-type CollectionFoldersConfiguration = boolean
-```
-
-```ts
-// Example usage
-
-import { buildConfig } from 'payload'
-
-const config = buildConfig({
-  collections: [
-    {
-      slug: 'pages',
-      // highlight-start
-      folders: true, // defaults to false
-      // highlight-end
-    },
-  ],
-})
-```

docs/getting-started/installation.mdx

@@ -81,7 +81,7 @@ To install a Database Adapter, you can run **one** of the following commands:
 
 #### 2. Copy Payload files into your Next.js app folder
 
-Payload installs directly in your Next.js `/app` folder, and you'll need to place some files into that folder for Payload to run. You can copy these files from the [Blank Template](<https://github.com/payloadcms/payload/tree/main/templates/blank/src/app/(payload)>) on GitHub. Once you have the required Payload files in place in your `/app` folder, you should have something like this:
+Payload installs directly in your Next.js `/app` folder, and you'll need to place some files into that folder for Payload to run. You can copy these files from the [Blank Template](https://github.com/payloadcms/payload/tree/main/templates/blank/src/app/(payload)) on GitHub. Once you have the required Payload files in place in your `/app` folder, you should have something like this:
 
 ```plaintext
 app/

docs/hooks/context.mdx

@@ -23,7 +23,7 @@ Let's see examples on how context can be used in the first two scenarios mention
 
 ### Passing Data Between Hooks
 
-To pass data between hooks, you can assign values to context in an earlier hook in the lifecycle of a request and expect it in the context of a later hook.
+To pass data between hooks, you can assign values to context in an earlier hook in the lifecycle of a request and expect it the context in a later hook.
 
 For example:
 

docs/jobs-queue/tasks.mdx

@@ -33,7 +33,7 @@ Simply add a task to the `jobs.tasks` array in your Payload config. A task consi
 | `onSuccess`     | Function to be executed if the task succeeds.                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `retries`       | Specify the number of times that this step should be retried if it fails. If this is undefined, the task will either inherit the retries from the workflow or have no retries. If this is 0, the task will not be retried. By default, this is undefined.                                                                                                                                                                                        |
 
-The logic for the Task is defined in the `handler` - which can be defined as a function, or a path to a function. The `handler` will run once a worker picks up a Job that includes this task.
+The logic for the Task is defined in the `handler` - which can be defined as a function, or a path to a function. The `handler` will run once a worker picks picks up a Job that includes this task.
 
 It should return an object with an `output` key, which should contain the output of the task as you've defined.
 
@@ -213,7 +213,7 @@ export default buildConfig({
 
 ## Nested tasks
 
-You can run sub-tasks within an existing task, by using the `tasks` or `inlineTask` arguments passed to the task `handler` function:
+You can run sub-tasks within an existing task, by using the `tasks` or `ìnlineTask` arguments passed to the task `handler` function:
 
 ```ts
 export default buildConfig({

docs/live-preview/client.mdx

@@ -260,7 +260,7 @@ If you are using relationships or uploads in your front-end application, and you
 {
   // ...
   // If your site is running on a different domain than your Payload server,
-  // This will allow requests to be made between the two domains
+  // This will allows requests to be made between the two domains
   cors: [
     'http://localhost:3001' // Your front-end application
   ],

docs/plugins/form-builder.mdx

@@ -85,7 +85,6 @@ formBuilderPlugin({
     checkbox: true,
     number: true,
     message: true,
-    date: false,
     payment: false,
   },
 })
@@ -350,18 +349,6 @@ Maps to a `checkbox` input on your front-end. Used to collect a boolean value.
 | `width`        | string   | The width of the field on the front-end.             |
 | `required`     | checkbox | Whether or not the field is required when submitted. |
 
-### Date
-
-Maps to a `date` input on your front-end. Used to collect a date value.
-
-| Property       | Type     | Description                                          |
-| -------------- | -------- | ---------------------------------------------------- |
-| `name`         | string   | The name of the field.                               |
-| `label`        | string   | The label of the field.                              |
-| `defaultValue` | date     | The default value of the field.                      |
-| `width`        | string   | The width of the field on the front-end.             |
-| `required`     | checkbox | Whether or not the field is required when submitted. |
-
 ### Number
 
 Maps to a `number` input on your front-end. Used to collect a number.
@@ -434,42 +421,6 @@ formBuilderPlugin({
 })
 ```
 
-### Customizing the date field default value
-
-You can custommise the default value of the date field and any other aspects of the date block in this way.
-Note that the end submission source will be responsible for the timezone of the date. Payload only stores the date in UTC format.
-
-```ts
-import { fields as formFields } from '@payloadcms/plugin-form-builder'
-
-// payload.config.ts
-formBuilderPlugin({
-  fields: {
-    // date: true, // just enable it without any customizations
-    date: {
-      ...formFields.date,
-      fields: [
-        ...(formFields.date && 'fields' in formFields.date
-          ? formFields.date.fields.map((field) => {
-              if ('name' in field && field.name === 'defaultValue') {
-                return {
-                  ...field,
-                  timezone: true, // optionally enable timezone
-                  admin: {
-                    ...field.admin,
-                    description: 'This is a date field',
-                  },
-                }
-              }
-              return field
-            })
-          : []),
-      ],
-    },
-  },
-})
-```
-
 ## Email
 
 This plugin relies on the [email configuration](../email/overview) defined in your Payload configuration. It will read from your config and attempt to send your emails using the credentials provided.

docs/query-presets/overview.mdx

@@ -50,6 +50,7 @@ The following options are available for Query Presets:
 | ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
 | `access`      | Used to define custom collection-level access control that applies to all presets. [More details](#access-control).             |
 | `constraints` | Used to define custom document-level access control that apply to individual presets. [More details](#document-access-control). |
+| `hooks`       | Used to add custom hooks to the query presets collection. [More details](#hooks).                                               |
 | `labels`      | Custom labels to use for the Query Presets collection.                                                                          |
 
 ## Access Control
@@ -59,7 +60,7 @@ Query Presets are subject to the same [Access Control](../access-control/overvie
 Access Control for Query Presets can be customized in two ways:
 
 1. [Collection Access Control](#collection-access-control): Applies to all presets. These rules are not controllable by the user and are statically defined in the config.
-2. [Document Access Control](#document-access-control): Applies to each individual preset. These rules are controllable by the user and are saved to the document.
+2. [Document Access Control](#document-access-control): Applies to each individual preset. These rules are controllable by the user and are dynamically defined on each record in the database.
 
 ### Collection Access Control
 
@@ -97,7 +98,7 @@ This example restricts all Query Presets to users with the role of `admin`.
 
 ### Document Access Control
 
-You can also define access control rules that apply to each specific preset. Users have the ability to define and modify these rules on the fly as they manage presets. These are saved dynamically in the database on each document.
+You can also define access control rules that apply to each specific preset. Users have the ability to define and modify these rules on the fly as they manage presets. These are saved dynamically in the database on each record.
 
 When a user manages a preset, document-level access control options will be available to them in the Admin Panel for each operation.
 
@@ -150,8 +151,8 @@ const config = buildConfig({
           }),
         },
       ],
-      // highlight-end
     },
+    // highlight-end
   },
 })
 ```
@@ -171,3 +172,65 @@ The following options are available for each constraint:
 | `value`  | The value to store in the database when this constraint is selected.     |
 | `fields` | An array of fields to render when this constraint is selected.           |
 | `access` | A function that determines the access control rules for this constraint. |
+
+## Hooks
+
+You can attach your own [Hooks](../hooks/overview) to the Query Presets collection. This can be useful for defining custom behavior when a preset is created, updated, or deleted.
+
+For example, you may want to add additional access control rules that prevent certain users from creating or updating presets in a certain way.
+
+To do this, you can use the `hooks` property in your [Payload Config](../configuration/overview):
+
+```ts
+import { buildConfig } from 'payload'
+
+const config = buildConfig({
+  // ...
+  queryPresets: {
+    // ...
+    // highlight-start
+    hooks: {
+      beforeValidate: [
+        // this is a custom `beforeValidate` hook that runs before the preset is validated
+        // it ensures that only admins can add or remove the "admin" role from a preset
+        ({ data, req, originalDoc }) => {
+          const adminRoleChanged = (current, original) => {
+            const currentHasAdmin = current?.roles?.includes('admin') ?? false
+            const originalHasAdmin = original?.roles?.includes('admin') ?? false
+            return currentHasAdmin !== originalHasAdmin
+          }
+
+          const readChanged =
+            data?.access?.read?.constraint === 'specificRoles' &&
+            adminRoleChanged(
+              data?.access?.read,
+              originalDoc?.access?.read || {},
+            )
+
+          const updateChanged =
+            data?.access?.update?.constraint === 'specificRoles' &&
+            adminRoleChanged(
+              data?.access?.update,
+              originalDoc?.access?.update || {},
+            )
+
+          if (
+            (readChanged || updateChanged) &&
+            !req.user?.roles?.includes('admin')
+          ) {
+            throw new APIError(
+              'You must be an admin to add or remove the admin role from a preset',
+              403,
+              {},
+              true,
+            )
+          }
+
+          return data
+        },
+      ],
+    },
+    // highlight-end
+  },
+})
+```

docs/rich-text/converting-html.mdx

@@ -6,14 +6,14 @@ desc: Converting between lexical richtext and HTML
 keywords: lexical, richtext, html
 ---
 
-## Rich Text to HTML
+## Converting Rich Text to HTML
 
 There are two main approaches to convert your Lexical-based rich text to HTML:
 
 1. **Generate HTML on-demand (Recommended)**: Convert JSON to HTML wherever you need it, on-demand.
 2. **Generate HTML within your Collection**: Create a new field that automatically converts your saved JSON content to HTML. This is not recommended because it adds overhead to the Payload API and may not work well with live preview.
 
-### On-demand
+### Generating HTML on-demand (Recommended)
 
 To convert JSON to HTML on-demand, use the `convertLexicalToHTML` function from `@payloadcms/richtext-lexical/html`. Here's an example of how to use it in a React component in your frontend:
 
@@ -32,81 +32,61 @@ export const MyComponent = ({ data }: { data: SerializedEditorState }) => {
 }
 ```
 
-#### Dynamic Population (Advanced)
+### Converting Lexical Blocks
 
-By default, `convertLexicalToHTML` expects fully populated data (e.g. uploads, links, etc.). If you need to dynamically fetch and populate those nodes, use the async variant, `convertLexicalToHTMLAsync`, from `@payloadcms/richtext-lexical/html-async`. You must provide a `populate` function:
+If your rich text includes Lexical blocks, you need to provide a way to convert them to HTML. For example:
 
 ```tsx
 'use client'
 
+import type { MyInlineBlock, MyTextBlock } from '@/payload-types'
+import type {
+  DefaultNodeTypes,
+  SerializedBlockNode,
+  SerializedInlineBlockNode,
+} from '@payloadcms/richtext-lexical'
 import type { SerializedEditorState } from '@payloadcms/richtext-lexical/lexical'
 
-import { getRestPopulateFn } from '@payloadcms/richtext-lexical/client'
-import { convertLexicalToHTMLAsync } from '@payloadcms/richtext-lexical/html-async'
-import React, { useEffect, useState } from 'react'
-
-export const MyComponent = ({ data }: { data: SerializedEditorState }) => {
-  const [html, setHTML] = useState<null | string>(null)
-  useEffect(() => {
-    async function convert() {
-      const html = await convertLexicalToHTMLAsync({
-        data,
-        populate: getRestPopulateFn({
-          apiURL: `http://localhost:3000/api`,
-        }),
-      })
-      setHTML(html)
-    }
-
-    void convert()
-  }, [data])
-
-  return html && <div dangerouslySetInnerHTML={{ __html: html }} />
-}
-```
-
-Using the REST populate function will send a separate request for each node. If you need to populate a large number of nodes, this may be slow. For improved performance on the server, you can use the `getPayloadPopulateFn` function:
-
-```tsx
-import type { SerializedEditorState } from '@payloadcms/richtext-lexical/lexical'
-
-import { getPayloadPopulateFn } from '@payloadcms/richtext-lexical'
-import { convertLexicalToHTMLAsync } from '@payloadcms/richtext-lexical/html-async'
-import { getPayload } from 'payload'
+import {
+  convertLexicalToHTML,
+  type HTMLConvertersFunction,
+} from '@payloadcms/richtext-lexical/html'
 import React from 'react'
 
-import config from '../../config.js'
+type NodeTypes =
+  | DefaultNodeTypes
+  | SerializedBlockNode<MyTextBlock>
+  | SerializedInlineBlockNode<MyInlineBlock>
 
-export const MyRSCComponent = async ({
-  data,
-}: {
-  data: SerializedEditorState
-}) => {
-  const payload = await getPayload({
-    config,
-  })
+const htmlConverters: HTMLConvertersFunction<NodeTypes> = ({
+  defaultConverters,
+}) => ({
+  ...defaultConverters,
+  blocks: {
+    // Each key should match your block's slug
+    myTextBlock: ({ node, providedCSSString }) =>
+      `<div style="background-color: red;${providedCSSString}">${node.fields.text}</div>`,
+  },
+  inlineBlocks: {
+    // Each key should match your inline block's slug
+    myInlineBlock: ({ node, providedStyleTag }) =>
+      `<span${providedStyleTag}>${node.fields.text}</span$>`,
+  },
+})
 
-  const html = await convertLexicalToHTMLAsync({
+export const MyComponent = ({ data }: { data: SerializedEditorState }) => {
+  const html = convertLexicalToHTML({
+    converters: htmlConverters,
     data,
-    populate: await getPayloadPopulateFn({
-      currentDepth: 0,
-      depth: 1,
-      payload,
-    }),
   })
 
-  return html && <div dangerouslySetInnerHTML={{ __html: html }} />
+  return <div dangerouslySetInnerHTML={{ __html: html }} />
 }
 ```
 
-### HTML field
+### Outputting HTML from the Collection
 
-The `lexicalHTMLField()` helper converts JSON to HTML and saves it in a field that is updated every time you read it via an `afterRead` hook. It's generally not recommended for two reasons:
-
-1. It creates a column with duplicate content in another format.
-2. In [client-side live preview](/docs/live-preview/client), it makes it not "live".
-
-Consider using the [on-demand HTML converter above](/docs/rich-text/converting-html#on-demand-recommended) or the [JSX converter](/docs/rich-text/converting-jsx) unless you have a good reason.
+To automatically generate HTML from the saved richText field in your Collection, use the `lexicalHTMLField()` helper. This approach converts the JSON to HTML using an `afterRead` hook. For instance:
 
 ```ts
 import type { HTMLConvertersFunction } from '@payloadcms/richtext-lexical/html'
@@ -174,59 +154,74 @@ const Pages: CollectionConfig = {
 }
 ```
 
-## Blocks to HTML
+### Generating HTML in Your Frontend with Dynamic Population (Advanced)
 
-If your rich text includes Lexical blocks, you need to provide a way to convert them to HTML. For example:
+By default, `convertLexicalToHTML` expects fully populated data (e.g. uploads, links, etc.). If you need to dynamically fetch and populate those nodes, use the async variant, `convertLexicalToHTMLAsync`, from `@payloadcms/richtext-lexical/html-async`. You must provide a `populate` function:
 
 ```tsx
 'use client'
 
-import type { MyInlineBlock, MyTextBlock } from '@/payload-types'
-import type {
-  DefaultNodeTypes,
-  SerializedBlockNode,
-  SerializedInlineBlockNode,
-} from '@payloadcms/richtext-lexical'
 import type { SerializedEditorState } from '@payloadcms/richtext-lexical/lexical'
 
-import {
-  convertLexicalToHTML,
-  type HTMLConvertersFunction,
-} from '@payloadcms/richtext-lexical/html'
-import React from 'react'
-
-type NodeTypes =
-  | DefaultNodeTypes
-  | SerializedBlockNode<MyTextBlock>
-  | SerializedInlineBlockNode<MyInlineBlock>
-
-const htmlConverters: HTMLConvertersFunction<NodeTypes> = ({
-  defaultConverters,
-}) => ({
-  ...defaultConverters,
-  blocks: {
-    // Each key should match your block's slug
-    myTextBlock: ({ node, providedCSSString }) =>
-      `<div style="background-color: red;${providedCSSString}">${node.fields.text}</div>`,
-  },
-  inlineBlocks: {
-    // Each key should match your inline block's slug
-    myInlineBlock: ({ node, providedStyleTag }) =>
-      `<span${providedStyleTag}>${node.fields.text}</span$>`,
-  },
-})
+import { getRestPopulateFn } from '@payloadcms/richtext-lexical/client'
+import { convertLexicalToHTMLAsync } from '@payloadcms/richtext-lexical/html-async'
+import React, { useEffect, useState } from 'react'
 
 export const MyComponent = ({ data }: { data: SerializedEditorState }) => {
-  const html = convertLexicalToHTML({
-    converters: htmlConverters,
-    data,
-  })
+  const [html, setHTML] = useState<null | string>(null)
+  useEffect(() => {
+    async function convert() {
+      const html = await convertLexicalToHTMLAsync({
+        data,
+        populate: getRestPopulateFn({
+          apiURL: `http://localhost:3000/api`,
+        }),
+      })
+      setHTML(html)
+    }
 
-  return <div dangerouslySetInnerHTML={{ __html: html }} />
+    void convert()
+  }, [data])
+
+  return html && <div dangerouslySetInnerHTML={{ __html: html }} />
 }
 ```
 
-## HTML to Richtext
+Using the REST populate function will send a separate request for each node. If you need to populate a large number of nodes, this may be slow. For improved performance on the server, you can use the `getPayloadPopulateFn` function:
+
+```tsx
+import type { SerializedEditorState } from '@payloadcms/richtext-lexical/lexical'
+
+import { getPayloadPopulateFn } from '@payloadcms/richtext-lexical'
+import { convertLexicalToHTMLAsync } from '@payloadcms/richtext-lexical/html-async'
+import { getPayload } from 'payload'
+import React from 'react'
+
+import config from '../../config.js'
+
+export const MyRSCComponent = async ({
+  data,
+}: {
+  data: SerializedEditorState
+}) => {
+  const payload = await getPayload({
+    config,
+  })
+
+  const html = await convertLexicalToHTMLAsync({
+    data,
+    populate: await getPayloadPopulateFn({
+      currentDepth: 0,
+      depth: 1,
+      payload,
+    }),
+  })
+
+  return html && <div dangerouslySetInnerHTML={{ __html: html }} />
+}
+```
+
+## Converting HTML to Richtext
 
 If you need to convert raw HTML into a Lexical editor state, use `convertHTMLToLexical` from `@payloadcms/richtext-lexical`, along with the [editorConfigFactory to retrieve the editor config](/docs/rich-text/converters#retrieving-the-editor-config):
 

docs/rich-text/converting-jsx.mdx

@@ -6,7 +6,7 @@ desc: Converting between lexical richtext and JSX
 keywords: lexical, richtext, jsx
 ---
 
-## Richtext to JSX
+## Converting Richtext to JSX
 
 To convert richtext to JSX, import the `RichText` component from `@payloadcms/richtext-lexical/react` and pass the richtext content to it:
 
@@ -28,7 +28,7 @@ The `RichText` component includes built-in converters for common Lexical nodes.
   populated data to work correctly.
 </Banner>
 
-### Internal Links
+### Converting Internal Links
 
 By default, Payload doesn't know how to convert **internal** links to JSX, as it doesn't know what the corresponding URL of the internal link is. You'll notice that you get a "found internal link, but internalDocToHref is not provided" error in the console when you try to render content with internal links.
 
@@ -81,7 +81,7 @@ export const MyComponent: React.FC<{
 }
 ```
 
-### Lexical Blocks
+### Converting Lexical Blocks
 
 If your rich text includes custom Blocks or Inline Blocks, you must supply custom converters that match each block's slug. This converter is not included by default, as Payload doesn't know how to render your custom blocks.
 
@@ -133,9 +133,9 @@ export const MyComponent: React.FC<{
 }
 ```
 
-### Overriding Converters
+### Overriding Default JSX Converters
 
-You can override any of the default JSX converters by passing your custom converter, keyed to the node type, to the `converters` prop / the converters function.
+You can override any of the default JSX converters by passing passing your custom converter, keyed to the node type, to the `converters` prop / the converters function.
 
 Example - overriding the upload node converter to use next/image:
 

docs/rich-text/converting-markdown.mdx

@@ -6,7 +6,7 @@ desc: Converting between lexical richtext and Markdown / MDX
 keywords: lexical, richtext, markdown, md, mdx
 ---
 
-## Richtext to Markdown
+## Converting Richtext to Markdown
 
 If you have access to the Payload Config and the [lexical editor config](/docs/rich-text/converters#retrieving-the-editor-config), you can convert the lexical editor state to Markdown with the following:
 
@@ -91,7 +91,7 @@ const Pages: CollectionConfig = {
 }
 ```
 
-## Markdown to Richtext
+## Converting Markdown to Richtext
 
 If you have access to the Payload Config and the [lexical editor config](/docs/rich-text/converters#retrieving-the-editor-config), you can convert Markdown to the lexical editor state with the following:
 

docs/rich-text/converting-plaintext.mdx

@@ -6,7 +6,7 @@ desc: Converting between lexical richtext and plaintext
 keywords: lexical, richtext, plaintext, text
 ---
 
-## Richtext to Plaintext
+## Converting Richtext to Plaintext
 
 Here's how you can convert richtext data to plaintext using `@payloadcms/richtext-lexical/plaintext`.
 

docs/rich-text/overview.mdx

@@ -142,33 +142,32 @@ import { CallToAction } from '../blocks/CallToAction'
 
 Here's an overview of all the included features:
 
-| Feature Name                        | Included by default | Description                                                                                                                                                                         |
-| ----------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **`BoldFeature`**                   | Yes                 | Handles the bold text format                                                                                                                                                        |
-| **`ItalicFeature`**                 | Yes                 | Handles the italic text format                                                                                                                                                      |
-| **`UnderlineFeature`**              | Yes                 | Handles the underline text format                                                                                                                                                   |
-| **`StrikethroughFeature`**          | Yes                 | Handles the strikethrough text format                                                                                                                                               |
-| **`SubscriptFeature`**              | Yes                 | Handles the subscript text format                                                                                                                                                   |
-| **`SuperscriptFeature`**            | Yes                 | Handles the superscript text format                                                                                                                                                 |
-| **`InlineCodeFeature`**             | Yes                 | Handles the inline-code text format                                                                                                                                                 |
-| **`ParagraphFeature`**              | Yes                 | Handles paragraphs. Since they are already a key feature of lexical itself, this Feature mainly handles the Slash and Add-Block menu entries for paragraphs                         |
-| **`HeadingFeature`**                | Yes                 | Adds Heading Nodes (by default, H1 - H6, but that can be customized)                                                                                                                |
-| **`AlignFeature`**                  | Yes                 | Allows you to align text left, centered and right                                                                                                                                   |
-| **`IndentFeature`**                 | Yes                 | Allows you to indent text with the tab key                                                                                                                                          |
-| **`UnorderedListFeature`**          | Yes                 | Adds unordered lists (ul)                                                                                                                                                           |
-| **`OrderedListFeature`**            | Yes                 | Adds ordered lists (ol)                                                                                                                                                             |
-| **`ChecklistFeature`**              | Yes                 | Adds checklists                                                                                                                                                                     |
-| **`LinkFeature`**                   | Yes                 | Allows you to create internal and external links                                                                                                                                    |
-| **`RelationshipFeature`**           | Yes                 | Allows you to create block-level (not inline) relationships to other documents                                                                                                      |
-| **`BlockquoteFeature`**             | Yes                 | Allows you to create block-level quotes                                                                                                                                             |
-| **`UploadFeature`**                 | Yes                 | Allows you to create block-level upload nodes - this supports all kinds of uploads, not just images                                                                                 |
-| **`HorizontalRuleFeature`**         | Yes                 | Horizontal rules / separators. Basically displays an `<hr>` element                                                                                                                 |
-| **`InlineToolbarFeature`**          | Yes                 | The inline toolbar is the floating toolbar which appears when you select text. This toolbar only contains actions relevant for selected text                                        |
-| **`FixedToolbarFeature`**           | No                  | This classic toolbar is pinned to the top and always visible. Both inline and fixed toolbars can be enabled at the same time.                                                       |
-| **`BlocksFeature`**                 | No                  | Allows you to use Payload's [Blocks Field](../fields/blocks) directly inside your editor. In the feature props, you can specify the allowed blocks - just like in the Blocks field. |
-| **`TreeViewFeature`**               | No                  | Adds a debug box under the editor, which allows you to see the current editor state live, the dom, as well as time travel. Very useful for debugging                                |
-| **`EXPERIMENTAL_TableFeature`**     | No                  | Adds support for tables. This feature may be removed or receive breaking changes in the future - even within a stable lexical release, without needing a major release.             |
-| **`EXPERIMENTAL_TextStateFeature`** | No                  | Allows you to store key-value attributes within TextNodes and assign them inline styles.                                                                                            |
+| Feature Name                    | Included by default | Description                                                                                                                                                                         |
+| ------------------------------- | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`BoldFeature`**               | Yes                 | Handles the bold text format                                                                                                                                                        |
+| **`ItalicFeature`**             | Yes                 | Handles the italic text format                                                                                                                                                      |
+| **`UnderlineFeature`**          | Yes                 | Handles the underline text format                                                                                                                                                   |
+| **`StrikethroughFeature`**      | Yes                 | Handles the strikethrough text format                                                                                                                                               |
+| **`SubscriptFeature`**          | Yes                 | Handles the subscript text format                                                                                                                                                   |
+| **`SuperscriptFeature`**        | Yes                 | Handles the superscript text format                                                                                                                                                 |
+| **`InlineCodeFeature`**         | Yes                 | Handles the inline-code text format                                                                                                                                                 |
+| **`ParagraphFeature`**          | Yes                 | Handles paragraphs. Since they are already a key feature of lexical itself, this Feature mainly handles the Slash and Add-Block menu entries for paragraphs                         |
+| **`HeadingFeature`**            | Yes                 | Adds Heading Nodes (by default, H1 - H6, but that can be customized)                                                                                                                |
+| **`AlignFeature`**              | Yes                 | Allows you to align text left, centered and right                                                                                                                                   |
+| **`IndentFeature`**             | Yes                 | Allows you to indent text with the tab key                                                                                                                                          |
+| **`UnorderedListFeature`**      | Yes                 | Adds unordered lists (ul)                                                                                                                                                           |
+| **`OrderedListFeature`**        | Yes                 | Adds ordered lists (ol)                                                                                                                                                             |
+| **`ChecklistFeature`**          | Yes                 | Adds checklists                                                                                                                                                                     |
+| **`LinkFeature`**               | Yes                 | Allows you to create internal and external links                                                                                                                                    |
+| **`RelationshipFeature`**       | Yes                 | Allows you to create block-level (not inline) relationships to other documents                                                                                                      |
+| **`BlockquoteFeature`**         | Yes                 | Allows you to create block-level quotes                                                                                                                                             |
+| **`UploadFeature`**             | Yes                 | Allows you to create block-level upload nodes - this supports all kinds of uploads, not just images                                                                                 |
+| **`HorizontalRuleFeature`**     | Yes                 | Horizontal rules / separators. Basically displays an `<hr>` element                                                                                                                 |
+| **`InlineToolbarFeature`**      | Yes                 | The inline toolbar is the floating toolbar which appears when you select text. This toolbar only contains actions relevant for selected text                                        |
+| **`FixedToolbarFeature`**       | No                  | This classic toolbar is pinned to the top and always visible. Both inline and fixed toolbars can be enabled at the same time.                                                       |
+| **`BlocksFeature`**             | No                  | Allows you to use Payload's [Blocks Field](../fields/blocks) directly inside your editor. In the feature props, you can specify the allowed blocks - just like in the Blocks field. |
+| **`TreeViewFeature`**           | No                  | Adds a debug box under the editor, which allows you to see the current editor state live, the dom, as well as time travel. Very useful for debugging                                |
+| **`EXPERIMENTAL_TableFeature`** | No                  | Adds support for tables. This feature may be removed or receive breaking changes in the future - even within a stable lexical release, without needing a major release.             |
 
 Notice how even the toolbars are features? That's how extensible our lexical editor is - you could theoretically create your own toolbar if you wanted to!
 

docs/versions/autosave.mdx

@@ -3,7 +3,7 @@ title: Autosave
 label: Autosave
 order: 30
 desc: Using Payload's Draft functionality, you can configure your collections and globals to autosave changes as drafts, and publish only you're ready.
-keywords: version history, revisions, audit log, draft, publish, autosave, Content Management System, cms, headless, javascript, node, react, nextjs
+keywords: version history, revisions, audit log, draft, publish, autosave, Content Management System, cms, headless, javascript, node, react, nextjss
 ---
 
 Extending on Payload's [Draft](/docs/versions/drafts) functionality, you can configure your collections and globals to autosave changes as drafts, and publish only you're ready. The Admin UI will automatically adapt to autosaving progress at an interval that you define, and will store all autosaved changes as a new Draft version. Never lose your work - and publish changes to the live document only when you're ready.

examples/auth/src/collections/Users.ts

@@ -1,7 +1,7 @@
 import type { CollectionConfig } from 'payload/types'
 
 import { admins } from './access/admins'
-import { adminsAndUser } from './access/adminsAndUser'
+import adminsAndUser from './access/adminsAndUser'
 import { anyone } from './access/anyone'
 import { checkRole } from './access/checkRole'
 import { loginAfterCreate } from './hooks/loginAfterCreate'
@@ -25,7 +25,6 @@ export const Users: CollectionConfig = {
     create: anyone,
     update: adminsAndUser,
     delete: admins,
-    unlock: admins,
     admin: ({ req: { user } }) => checkRole(['admin'], user),
   },
   hooks: {

examples/auth/src/collections/access/admins.ts

@@ -1,4 +1,4 @@
-import type { Access } from 'payload'
+import type { Access } from 'payload/config'
 
 import { checkRole } from './checkRole'
 

examples/auth/src/collections/access/adminsAndUser.ts

@@ -1,17 +1,19 @@
-import type { Access } from 'payload'
+import type { Access } from 'payload/config'
 
 import { checkRole } from './checkRole'
 
-export const adminsAndUser: Access = ({ req: { user } }) => {
+const adminsAndUser: Access = ({ req: { user } }) => {
   if (user) {
     if (checkRole(['admin'], user)) {
       return true
     }
 
     return {
-      id: { equals: user.id },
+      id: user.id,
     }
   }
 
   return false
 }
+
+export default adminsAndUser

examples/auth/src/collections/access/anyone.ts

@@ -1,3 +1,3 @@
-import type { Access } from 'payload'
+import type { Access } from 'payload/config'
 
 export const anyone: Access = () => true

examples/auth/src/collections/access/checkRole.ts

@@ -1,6 +1,6 @@
 import type { User } from '../../payload-types'
 
-export const checkRole = (allRoles: User['roles'] = [], user: User | null = null): boolean => {
+export const checkRole = (allRoles: User['roles'] = [], user: User = undefined): boolean => {
   if (user) {
     if (
       allRoles.some((role) => {
@@ -8,9 +8,8 @@ export const checkRole = (allRoles: User['roles'] = [], user: User | null = null
           return individualRole === role
         })
       })
-    ) {
-      return true
-    }
+    )
+      {return true}
   }
 
   return false

examples/auth/src/collections/hooks/protectRoles.ts

@@ -1,4 +1,4 @@
-import type { FieldHook } from 'payload'
+import type { FieldHook } from 'payload/types'
 
 import type { User } from '../../payload-types'
 

examples/custom-server/src/payload.config.ts

@@ -1,6 +1,7 @@
 import { mongooseAdapter } from '@payloadcms/db-mongodb'
 import { lexicalEditor } from '@payloadcms/richtext-lexical'
 import path from 'path'
+import express from 'express'
 import { buildConfig } from 'payload'
 import { fileURLToPath } from 'url'
 

examples/custom-server/src/server.ts

@@ -1,4 +1,5 @@
 import express from 'express'
+import type { Request, Response } from 'express'
 import { parse } from 'url'
 import next from 'next'
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "payload-monorepo",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "private": true,
   "type": "module",
   "scripts": {

packages/admin-bar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/admin-bar",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "An admin bar for React apps using Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/create-payload-app/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-payload-app",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "homepage": "https://payloadcms.com",
   "repository": {
     "type": "git",

packages/create-payload-app/src/lib/constants.ts

@@ -0,0 +1,8 @@
+import { readFileSync } from 'fs'
+import { fileURLToPath } from 'node:url'
+import path from 'path'
+const filename = fileURLToPath(import.meta.url)
+const dirname = path.dirname(filename)
+
+const packageJson = JSON.parse(readFileSync(path.resolve(dirname, '../../package.json'), 'utf-8'))
+export const PACKAGE_VERSION = packageJson.version

packages/create-payload-app/src/lib/templates.ts

@@ -1,8 +1,9 @@
 import type { ProjectTemplate } from '../types.js'
 
 import { error, info } from '../utils/log.js'
+import { PACKAGE_VERSION } from './constants.js'
 
-export function validateTemplate({ templateName }: { templateName: string }): boolean {
+export function validateTemplate(templateName: string): boolean {
   const validTemplates = getValidTemplates()
   if (!validTemplates.map((t) => t.name).includes(templateName)) {
     error(`'${templateName}' is not a valid template.`)
@@ -19,13 +20,13 @@ export function getValidTemplates(): ProjectTemplate[] {
       name: 'blank',
       type: 'starter',
       description: 'Blank 3.0 Template',
-      url: `https://github.com/payloadcms/payload/templates/blank#main`,
+      url: `https://github.com/payloadcms/payload/templates/blank#v${PACKAGE_VERSION}`,
     },
     {
       name: 'website',
       type: 'starter',
       description: 'Website Template',
-      url: `https://github.com/payloadcms/payload/templates/website#main`,
+      url: `https://github.com/payloadcms/payload/templates/website#v${PACKAGE_VERSION}`,
     },
     {
       name: 'plugin',

packages/create-payload-app/src/lib/update-payload-in-project.ts

@@ -1,3 +1,4 @@
+import execa from 'execa'
 import fse from 'fs-extra'
 import { fileURLToPath } from 'node:url'
 import path from 'path'
@@ -8,7 +9,6 @@ const dirname = path.dirname(filename)
 import type { NextAppDetails } from '../types.js'
 
 import { copyRecursiveSync } from '../utils/copy-recursive-sync.js'
-import { getLatestPackageVersion } from '../utils/getLatestPackageVersion.js'
 import { info } from '../utils/log.js'
 import { getPackageManager } from './get-package-manager.js'
 import { installPackages } from './install-packages.js'
@@ -36,8 +36,15 @@ export async function updatePayloadInProject(
 
   const packageManager = await getPackageManager({ projectDir })
 
-  // Fetch latest Payload version
-  const latestPayloadVersion = await getLatestPackageVersion({ packageName: 'payload' })
+  // Fetch latest Payload version from npm
+  const { exitCode: getLatestVersionExitCode, stdout: latestPayloadVersion } = await execa('npm', [
+    'show',
+    'payload',
+    'version',
+  ])
+  if (getLatestVersionExitCode !== 0) {
+    throw new Error('Failed to fetch latest Payload version')
+  }
 
   if (payloadVersion === latestPayloadVersion) {
     return { message: `Payload v${payloadVersion} is already up to date.`, success: true }

packages/create-payload-app/src/main.ts

@@ -8,6 +8,7 @@ import path from 'path'
 import type { CliArgs } from './types.js'
 
 import { configurePayloadConfig } from './lib/configure-payload-config.js'
+import { PACKAGE_VERSION } from './lib/constants.js'
 import { createProject } from './lib/create-project.js'
 import { parseExample } from './lib/examples.js'
 import { generateSecret } from './lib/generate-secret.js'
@@ -19,7 +20,6 @@ import { parseTemplate } from './lib/parse-template.js'
 import { selectDb } from './lib/select-db.js'
 import { getValidTemplates, validateTemplate } from './lib/templates.js'
 import { updatePayloadInProject } from './lib/update-payload-in-project.js'
-import { getLatestPackageVersion } from './utils/getLatestPackageVersion.js'
 import { debug, error, info } from './utils/log.js'
 import {
   feedbackOutro,
@@ -78,18 +78,13 @@ export class Main {
 
   async init(): Promise<void> {
     try {
-      const debugFlag = this.args['--debug']
-
-      const LATEST_VERSION = await getLatestPackageVersion({
-        debug: debugFlag,
-        packageName: 'payload',
-      })
-
       if (this.args['--help']) {
         helpMessage()
         process.exit(0)
       }
 
+      const debugFlag = this.args['--debug']
+
       // eslint-disable-next-line no-console
       console.log('\n')
       p.intro(chalk.bgCyan(chalk.black(' create-payload-app ')))
@@ -205,7 +200,7 @@ export class Main {
 
       const templateArg = this.args['--template']
       if (templateArg) {
-        const valid = validateTemplate({ templateName: templateArg })
+        const valid = validateTemplate(templateArg)
         if (!valid) {
           helpMessage()
           process.exit(1)
@@ -235,7 +230,7 @@ export class Main {
       }
 
       if (debugFlag) {
-        debug(`Using ${exampleArg ? 'examples' : 'templates'} from git tag: v${LATEST_VERSION}`)
+        debug(`Using ${exampleArg ? 'examples' : 'templates'} from git tag: v${PACKAGE_VERSION}`)
       }
 
       if (!exampleArg) {

packages/create-payload-app/src/utils/getLatestPackageVersion.ts

@@ -1,34 +0,0 @@
-/**
- * Fetches the latest version of a package from the NPM registry.
- *
- * Used in determining the latest version of Payload to use in the generated templates.
- */
-export async function getLatestPackageVersion({
-  debug = false,
-  packageName = 'payload',
-}: {
-  debug?: boolean
-  /**
-   * Package name to fetch the latest version for based on the NPM registry URL
-   *
-   * Eg. for `'payload'`, it will fetch the version from `https://registry.npmjs.org/payload`
-   *
-   * @default 'payload'
-   */
-  packageName?: string
-}) {
-  try {
-    const response = await fetch(`https://registry.npmjs.org/${packageName}`)
-    const data = await response.json()
-    const latestVersion = data['dist-tags'].latest
-
-    if (debug) {
-      console.log(`Found latest version of ${packageName}: ${latestVersion}`)
-    }
-
-    return latestVersion
-  } catch (error) {
-    console.error('Error fetching Payload version:', error)
-    throw error
-  }
-}

packages/db-mongodb/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/db-mongodb",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The officially supported MongoDB database adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/db-mongodb/src/queries/buildSearchParams.ts

@@ -20,6 +20,7 @@ type SearchParam = {
 
 const subQueryOptions = {
   lean: true,
+  limit: 50,
 }
 
 /**
@@ -183,7 +184,7 @@ export async function buildSearchParam({
             select[joinPath] = true
           }
 
-          const result = await SubModel.find(subQuery).lean().select(select)
+          const result = await SubModel.find(subQuery).lean().limit(50).select(select)
 
           const $in: unknown[] = []
 

packages/db-postgres/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/db-postgres",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The officially supported Postgres database adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/db-sqlite/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/db-sqlite",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The officially supported SQLite database adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/db-vercel-postgres/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/db-vercel-postgres",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "Vercel Postgres adapter for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/drizzle/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/drizzle",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "A library of shared functions used by different payload database adapters",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/drizzle/src/migrateReset.ts

@@ -28,8 +28,6 @@ export async function migrateReset(this: DrizzleAdapter): Promise<void> {
 
   const req = await createLocalReq({}, payload)
 
-  existingMigrations.reverse()
-
   // Rollback all migrations in order
   for (const migration of existingMigrations) {
     const migrationFile = migrationFiles.find((m) => m.name === migration.name)

packages/email-nodemailer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/email-nodemailer",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "Payload Nodemailer Email Adapter",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/email-resend/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/email-resend",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "Payload Resend Email Adapter",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/graphql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/graphql",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "homepage": "https://payloadcms.com",
   "repository": {
     "type": "git",

packages/live-preview-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/live-preview-react",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The official React SDK for Payload Live Preview",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/live-preview-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/live-preview-vue",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The official Vue SDK for Payload Live Preview",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/live-preview/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/live-preview",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The official live preview JavaScript SDK for Payload",
   "homepage": "https://payloadcms.com",
   "repository": {

packages/next/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/next",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "homepage": "https://payloadcms.com",
   "repository": {
     "type": "git",

packages/next/src/elements/DocumentHeader/Tabs/Tab/TabLink.tsx

@@ -1,7 +1,7 @@
 'use client'
 import type { SanitizedConfig } from 'payload'
 
-import { Button } from '@payloadcms/ui'
+import { Link } from '@payloadcms/ui'
 import { useParams, usePathname, useSearchParams } from 'next/navigation.js'
 import { formatAdminURL } from 'payload/shared'
 import React from 'react'
@@ -13,6 +13,7 @@ export const DocumentTabLink: React.FC<{
   children?: React.ReactNode
   href: string
   isActive?: boolean
+  isCollection?: boolean
   newTab?: boolean
 }> = ({
   adminRoute,
@@ -53,18 +54,19 @@ export const DocumentTabLink: React.FC<{
     isActiveFromProps
 
   return (
-    <Button
+    <li
       aria-label={ariaLabel}
-      buttonStyle="tab"
       className={[baseClass, isActive && `${baseClass}--active`].filter(Boolean).join(' ')}
-      disabled={isActive}
-      el={!isActive || href !== pathname ? 'link' : 'div'}
-      margin={false}
-      newTab={newTab}
-      size="medium"
-      to={!isActive || href !== pathname ? hrefWithLocale : undefined}
     >
-      {children}
-    </Button>
+      <Link
+        className={`${baseClass}__link`}
+        href={!isActive || href !== pathname ? hrefWithLocale : ''}
+        prefetch={false}
+        {...(newTab && { rel: 'noopener noreferrer', target: '_blank' })}
+        tabIndex={isActive ? -1 : 0}
+      >
+        {children}
+      </Link>
+    </li>
   )
 }

packages/next/src/elements/DocumentHeader/Tabs/Tab/index.scss

@@ -1,24 +1,74 @@
+@import '../../../../scss/styles.scss';
+
 @layer payload-default {
   .doc-tab {
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    white-space: nowrap;
+    @extend %h5;
+    position: relative;
+
+    &__link {
+      text-decoration: none;
+      display: flex;
+      justify-content: center;
+      align-items: center;
+      white-space: nowrap;
+
+      // Use a pseudo element for the accessability so that it doesn't take up DOM space
+      // Also because the parent element has `overflow: hidden` which would clip an outline
+      &:focus-visible::after {
+        content: '';
+        border: var(--accessibility-outline);
+        position: absolute;
+        top: 0;
+        right: 0;
+        bottom: 0;
+        left: 0;
+        pointer-events: none;
+      }
+    }
+
+    &:focus:not(:focus-visible) {
+      opacity: 1;
+    }
+
+    &::before {
+      content: '';
+      display: block;
+      position: absolute;
+      width: 100%;
+      height: 100%;
+      border-radius: var(--style-radius-s);
+      background-color: var(--theme-elevation-50);
+      opacity: 0;
+    }
 
     &:hover {
-      .pill-version-count {
+      &::before {
+        opacity: 1;
+      }
+
+      .doc-tab__count {
         background-color: var(--theme-elevation-150);
       }
     }
 
     &--active {
-      .pill-version-count {
-        background-color: var(--theme-elevation-250);
+      font-weight: 600;
+      &::before {
+        opacity: 1;
+        background-color: var(--theme-elevation-100);
+      }
+
+      .doc-tab {
+        &__count {
+          background-color: var(--theme-elevation-250);
+        }
       }
 
       &:hover {
-        .pill-version-count {
-          background-color: var(--theme-elevation-250);
+        .doc-tab {
+          &__count {
+            background-color: var(--theme-elevation-250);
+          }
         }
       }
     }
@@ -30,7 +80,16 @@
       gap: 4px;
       width: 100%;
       height: 100%;
-      line-height: calc(var(--base) * 1.2);
+      line-height: base(1.2);
+      padding: base(0.2) base(0.6);
+    }
+
+    &__count {
+      line-height: base(0.8);
+      min-width: base(0.8);
+      text-align: center;
+      background-color: var(--theme-elevation-100);
+      border-radius: var(--style-radius-s);
     }
   }
 }

packages/next/src/elements/DocumentHeader/Tabs/Tab/index.tsx

@@ -68,6 +68,7 @@ export const DocumentTab: React.FC<
         baseClass={baseClass}
         href={href}
         isActive={isActive}
+        isCollection={!!collectionConfig && !globalConfig}
         newTab={newTab}
       >
         <span className={`${baseClass}__label`}>

packages/next/src/elements/DocumentHeader/Tabs/tabs/VersionsPill/index.scss

@@ -1,9 +0,0 @@
-@layer payload-default {
-  .pill-version-count {
-    line-height: calc(var(--base) * 0.8);
-    min-width: calc(var(--base) * 0.8);
-    text-align: center;
-    background-color: var(--theme-elevation-100);
-    border-radius: var(--style-radius-s);
-  }
-}

packages/next/src/elements/DocumentHeader/Tabs/tabs/VersionsPill/index.tsx

@@ -2,9 +2,7 @@
 import { useDocumentInfo } from '@payloadcms/ui'
 import React from 'react'
 
-import './index.scss'
-
-const baseClass = 'pill-version-count'
+import { baseClass } from '../../Tab/index.js'
 
 export const VersionsPill: React.FC = () => {
   const { versionCount } = useDocumentInfo()
@@ -13,5 +11,5 @@ export const VersionsPill: React.FC = () => {
     return null
   }
 
-  return <span className={baseClass}>{versionCount}</span>
+  return <span className={`${baseClass}__count`}>{versionCount}</span>
 }

packages/next/src/elements/Nav/index.client.tsx

@@ -4,7 +4,7 @@ import type { groupNavItems } from '@payloadcms/ui/shared'
 import type { NavPreferences } from 'payload'
 
 import { getTranslation } from '@payloadcms/translations'
-import { BrowseByFolderButton, Link, NavGroup, useConfig, useTranslation } from '@payloadcms/ui'
+import { Link, NavGroup, useConfig, useTranslation } from '@payloadcms/ui'
 import { EntityType } from '@payloadcms/ui/shared'
 import { usePathname } from 'next/navigation.js'
 import { formatAdminURL } from 'payload/shared'
@@ -20,35 +20,14 @@ export const DefaultNavClient: React.FC<{
 
   const {
     config: {
-      admin: {
-        routes: { browseByFolder: foldersRoute },
-      },
-      collections,
       routes: { admin: adminRoute },
     },
   } = useConfig()
 
-  const [folderCollectionSlugs] = React.useState<string[]>(() => {
-    return collections.reduce<string[]>((acc, collection) => {
-      if (collection.folders) {
-        acc.push(collection.slug)
-      }
-      return acc
-    }, [])
-  })
-
   const { i18n } = useTranslation()
 
-  const folderURL = formatAdminURL({
-    adminRoute,
-    path: foldersRoute,
-  })
-
-  const viewingRootFolderView = pathname.startsWith(folderURL)
-
   return (
     <Fragment>
-      {folderCollectionSlugs.length > 0 && <BrowseByFolderButton active={viewingRootFolderView} />}
       {groups.map(({ entities, label }, key) => {
         return (
           <NavGroup isOpen={navPreferences?.groups?.[label]?.open} key={key} label={label}>

packages/next/src/views/BrowseByFolder/buildView.tsx

@@ -1,160 +0,0 @@
-import type {
-  AdminViewServerProps,
-  BuildCollectionFolderViewResult,
-  FolderListViewServerPropsOnly,
-  ListQuery,
-} from 'payload'
-
-import { DefaultBrowseByFolderView, FolderProvider, HydrateAuthProvider } from '@payloadcms/ui'
-import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'
-import { formatAdminURL } from '@payloadcms/ui/shared'
-import { redirect } from 'next/navigation.js'
-import { getFolderData } from 'payload'
-import React from 'react'
-
-import { getPreferences } from '../../utilities/getPreferences.js'
-
-export type BuildFolderViewArgs = {
-  customCellProps?: Record<string, any>
-  disableBulkDelete?: boolean
-  disableBulkEdit?: boolean
-  enableRowSelections: boolean
-  folderID?: number | string
-  isInDrawer?: boolean
-  overrideEntityVisibility?: boolean
-  query: ListQuery
-} & AdminViewServerProps
-
-export const buildBrowseByFolderView = async (
-  args: BuildFolderViewArgs,
-): Promise<BuildCollectionFolderViewResult> => {
-  const {
-    disableBulkDelete,
-    disableBulkEdit,
-    enableRowSelections,
-    folderCollectionSlugs,
-    folderID,
-    initPageResult,
-    isInDrawer,
-    params,
-    query: queryFromArgs,
-    searchParams,
-  } = args
-
-  const {
-    locale: fullLocale,
-    permissions,
-    req: {
-      i18n,
-      payload,
-      payload: { config },
-      query: queryFromReq,
-      user,
-    },
-    visibleEntities,
-  } = initPageResult
-
-  const collections = folderCollectionSlugs.filter(
-    (collectionSlug) =>
-      permissions?.collections?.[collectionSlug]?.read &&
-      visibleEntities.collections.includes(collectionSlug),
-  )
-
-  if (!collections.length) {
-    throw new Error('not-found')
-  }
-
-  const query = queryFromArgs || queryFromReq
-  const selectedCollectionSlugs: string[] =
-    Array.isArray(query?.relationTo) && query.relationTo.length
-      ? query.relationTo
-      : [...folderCollectionSlugs, config.folders.slug]
-
-  const {
-    routes: { admin: adminRoute },
-  } = config
-
-  const { breadcrumbs, documents, subfolders } = await getFolderData({
-    folderID,
-    req: initPageResult.req,
-    search: query?.search as string,
-  })
-
-  const resolvedFolderID = breadcrumbs[breadcrumbs.length - 1]?.id
-
-  if (
-    !isInDrawer &&
-    ((resolvedFolderID && folderID && folderID !== resolvedFolderID) ||
-      (folderID && !resolvedFolderID))
-  ) {
-    redirect(
-      formatAdminURL({
-        adminRoute,
-        path: config.admin.routes.browseByFolder,
-        serverURL: config.serverURL,
-      }),
-    )
-  }
-
-  const browseByFolderPreferences = await getPreferences<{ viewPreference: string }>(
-    'browse-by-folder',
-    payload,
-    user.id,
-    user.collection,
-  )
-
-  const serverProps: Omit<FolderListViewServerPropsOnly, 'collectionConfig' | 'listPreferences'> = {
-    documents,
-    i18n,
-    locale: fullLocale,
-    params,
-    payload,
-    permissions,
-    searchParams,
-    subfolders,
-    user,
-  }
-
-  // const folderViewSlots = renderFolderViewSlots({
-  //   clientProps: {
-  //   },
-  //   description: staticDescription,
-  //   payload,
-  //   serverProps,
-  // })
-
-  // documents cannot be created without a parent folder in this view
-  const hasCreatePermissionCollectionSlugs = folderID
-    ? [config.folders.slug, ...folderCollectionSlugs]
-    : [config.folders.slug]
-
-  return {
-    View: (
-      <FolderProvider
-        breadcrumbs={breadcrumbs}
-        documents={documents}
-        filteredCollectionSlugs={selectedCollectionSlugs}
-        folderCollectionSlugs={folderCollectionSlugs}
-        folderID={folderID}
-        subfolders={subfolders}
-      >
-        <HydrateAuthProvider permissions={permissions} />
-        {RenderServerComponent({
-          clientProps: {
-            // ...folderViewSlots,
-            disableBulkDelete,
-            disableBulkEdit,
-            enableRowSelections,
-            hasCreatePermissionCollectionSlugs,
-            selectedCollectionSlugs,
-            viewPreference: browseByFolderPreferences?.value?.viewPreference,
-          },
-          // Component:config.folders?.components?.views?.list?.Component,
-          Fallback: DefaultBrowseByFolderView,
-          importMap: payload.importMap,
-          serverProps,
-        })}
-      </FolderProvider>
-    ),
-  }
-}

packages/next/src/views/BrowseByFolder/index.tsx

@@ -1,23 +0,0 @@
-import type React from 'react'
-
-import { notFound } from 'next/navigation.js'
-
-import type { BuildFolderViewArgs } from './buildView.js'
-
-import { buildBrowseByFolderView } from './buildView.js'
-
-export const BrowseByFolder: React.FC<BuildFolderViewArgs> = async (args) => {
-  try {
-    const { View } = await buildBrowseByFolderView(args)
-    return View
-  } catch (error) {
-    if (error?.message === 'NEXT_REDIRECT') {
-      throw error
-    }
-    if (error.message === 'not-found') {
-      notFound()
-    } else {
-      console.error(error) // eslint-disable-line no-console
-    }
-  }
-}

packages/next/src/views/BrowseByFolder/metadata.ts

@@ -1,23 +0,0 @@
-import type { Metadata } from 'next'
-
-import type { GenerateViewMetadata } from '../Root/index.js'
-
-import { generateMetadata } from '../../utilities/meta.js'
-
-export const generateBrowseByFolderMetadata = async (
-  args: Parameters<GenerateViewMetadata>[0],
-): Promise<Metadata> => {
-  const { config, i18n } = args
-
-  const title: string = i18n.t('folder:browseByFolder')
-  const description: string = ''
-  const keywords: string = ''
-
-  return generateMetadata({
-    ...(config.admin.meta || {}),
-    description,
-    keywords,
-    serverURL: config.serverURL,
-    title,
-  })
-}

packages/next/src/views/CollectionFolders/buildView.tsx

@@ -1,206 +0,0 @@
-import type {
-  AdminViewServerProps,
-  BuildCollectionFolderViewResult,
-  FolderListViewServerPropsOnly,
-  ListQuery,
-  Where,
-} from 'payload'
-
-import { DefaultCollectionFolderView, FolderProvider, HydrateAuthProvider } from '@payloadcms/ui'
-import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'
-import { formatAdminURL, mergeListSearchAndWhere } from '@payloadcms/ui/shared'
-import { redirect } from 'next/navigation.js'
-import { getFolderData, parseDocumentID } from 'payload'
-import React from 'react'
-
-import { getPreferences } from '../../utilities/getPreferences.js'
-
-// import { renderFolderViewSlots } from './renderFolderViewSlots.js'
-
-export type BuildCollectionFolderViewStateArgs = {
-  disableBulkDelete?: boolean
-  disableBulkEdit?: boolean
-  enableRowSelections: boolean
-  folderID?: number | string
-  isInDrawer?: boolean
-  overrideEntityVisibility?: boolean
-  query: ListQuery
-} & AdminViewServerProps
-
-/**
- * Builds the entire view for collection-folder views on the server
- */
-export const buildCollectionFolderView = async (
-  args: BuildCollectionFolderViewStateArgs,
-): Promise<BuildCollectionFolderViewResult> => {
-  const {
-    disableBulkDelete,
-    disableBulkEdit,
-    enableRowSelections,
-    folderCollectionSlugs,
-    folderID,
-    initPageResult,
-    isInDrawer,
-    overrideEntityVisibility,
-    params,
-    query: queryFromArgs,
-    searchParams,
-  } = args
-
-  const {
-    collectionConfig,
-    collectionConfig: { slug: collectionSlug },
-    locale: fullLocale,
-    permissions,
-    req: {
-      i18n,
-      payload,
-      payload: { config },
-      query: queryFromReq,
-      user,
-    },
-    visibleEntities,
-  } = initPageResult
-
-  if (!permissions?.collections?.[collectionSlug]?.read) {
-    throw new Error('not-found')
-  }
-
-  if (collectionConfig) {
-    const query = queryFromArgs || queryFromReq
-
-    const collectionFolderPreferences = await getPreferences<{ viewPreference: string }>(
-      `${collectionSlug}-collection-folder`,
-      payload,
-      user.id,
-      user.collection,
-    )
-
-    const {
-      routes: { admin: adminRoute },
-    } = config
-
-    if (
-      (!visibleEntities.collections.includes(collectionSlug) && !overrideEntityVisibility) ||
-      !folderCollectionSlugs.includes(collectionSlug)
-    ) {
-      throw new Error('not-found')
-    }
-
-    const whereConstraints = [
-      mergeListSearchAndWhere({
-        collectionConfig,
-        search: typeof query?.search === 'string' ? query.search : undefined,
-        where: (query?.where as Where) || undefined,
-      }),
-    ]
-
-    if (folderID) {
-      whereConstraints.push({
-        [config.folders.fieldName]: {
-          equals: parseDocumentID({ id: folderID, collectionSlug, payload }),
-        },
-      })
-    } else {
-      whereConstraints.push({
-        [config.folders.fieldName]: {
-          exists: false,
-        },
-      })
-    }
-
-    const { breadcrumbs, documents, subfolders } = await getFolderData({
-      collectionSlug,
-      folderID,
-      req: initPageResult.req,
-      search: query?.search as string,
-    })
-
-    const resolvedFolderID = breadcrumbs[breadcrumbs.length - 1]?.id
-
-    if (
-      !isInDrawer &&
-      ((resolvedFolderID && folderID && folderID !== resolvedFolderID) ||
-        (folderID && !resolvedFolderID))
-    ) {
-      redirect(
-        formatAdminURL({
-          adminRoute,
-          path: `/collections/${collectionSlug}/${config.folders.slug}`,
-          serverURL: config.serverURL,
-        }),
-      )
-    }
-
-    const newDocumentURL = formatAdminURL({
-      adminRoute,
-      path: `/collections/${collectionSlug}/create`,
-    })
-
-    const hasCreatePermission = permissions?.collections?.[collectionSlug]?.create
-
-    const serverProps: FolderListViewServerPropsOnly = {
-      collectionConfig,
-      documents,
-      i18n,
-      locale: fullLocale,
-      params,
-      payload,
-      permissions,
-      searchParams,
-      subfolders,
-      user,
-    }
-
-    // We could support slots in the folder view in the future
-    // const folderViewSlots = renderFolderViewSlots({
-    //   clientProps: {
-    //     collectionSlug,
-    //     hasCreatePermission,
-    //     newDocumentURL,
-    //   },
-    //   collectionConfig,
-    //   description: typeof collectionConfig.admin.description === 'function'
-    //   ? collectionConfig.admin.description({ t: i18n.t })
-    //   : collectionConfig.admin.description,
-    //   payload,
-    //   serverProps,
-    // })
-
-    const search = query?.search as string
-
-    return {
-      View: (
-        <FolderProvider
-          breadcrumbs={breadcrumbs}
-          collectionSlug={collectionSlug}
-          documents={documents}
-          folderCollectionSlugs={folderCollectionSlugs}
-          folderID={folderID}
-          search={search}
-          subfolders={subfolders}
-        >
-          <HydrateAuthProvider permissions={permissions} />
-          {RenderServerComponent({
-            clientProps: {
-              // ...folderViewSlots,
-              collectionSlug,
-              disableBulkDelete,
-              disableBulkEdit,
-              enableRowSelections,
-              hasCreatePermission,
-              newDocumentURL,
-              viewPreference: collectionFolderPreferences?.value?.viewPreference,
-            },
-            Component: collectionConfig?.admin?.components?.views?.list?.Component,
-            Fallback: DefaultCollectionFolderView,
-            importMap: payload.importMap,
-            serverProps,
-          })}
-        </FolderProvider>
-      ),
-    }
-  }
-
-  throw new Error('not-found')
-}

packages/next/src/views/CollectionFolders/index.tsx

@@ -1,23 +0,0 @@
-import type React from 'react'
-
-import { notFound } from 'next/navigation.js'
-
-import type { BuildCollectionFolderViewStateArgs } from './buildView.js'
-
-import { buildCollectionFolderView } from './buildView.js'
-
-export const CollectionFolderView: React.FC<BuildCollectionFolderViewStateArgs> = async (args) => {
-  try {
-    const { View } = await buildCollectionFolderView(args)
-    return View
-  } catch (error) {
-    if (error?.message === 'NEXT_REDIRECT') {
-      throw error
-    }
-    if (error.message === 'not-found') {
-      notFound()
-    } else {
-      console.error(error) // eslint-disable-line no-console
-    }
-  }
-}

packages/next/src/views/CollectionFolders/metadata.ts

@@ -1,35 +0,0 @@
-import type { Metadata } from 'next'
-import type { SanitizedCollectionConfig } from 'payload'
-
-import { getTranslation } from '@payloadcms/translations'
-
-import type { GenerateViewMetadata } from '../Root/index.js'
-
-import { generateMetadata } from '../../utilities/meta.js'
-
-export const generateCollectionFolderMetadata = async (
-  args: {
-    collectionConfig: SanitizedCollectionConfig
-  } & Parameters<GenerateViewMetadata>[0],
-): Promise<Metadata> => {
-  const { collectionConfig, config, i18n } = args
-
-  let title: string = ''
-  const description: string = ''
-  const keywords: string = ''
-
-  if (collectionConfig) {
-    title = getTranslation(collectionConfig.labels.singular, i18n)
-  }
-
-  title = `${title ? `${title} ` : title}${i18n.t('folder:folders')}`
-
-  return generateMetadata({
-    ...(config.admin.meta || {}),
-    description,
-    keywords,
-    serverURL: config.serverURL,
-    title,
-    ...(collectionConfig?.admin?.meta || {}),
-  })
-}

packages/next/src/views/CollectionFolders/renderFolderViewSlots.tsx

@@ -1,99 +0,0 @@
-import type {
-  AfterFolderListClientProps,
-  AfterFolderListTableClientProps,
-  AfterFolderListTableServerPropsOnly,
-  BeforeFolderListClientProps,
-  BeforeFolderListServerPropsOnly,
-  BeforeFolderListTableClientProps,
-  BeforeFolderListTableServerPropsOnly,
-  FolderListViewServerPropsOnly,
-  FolderListViewSlots,
-  ListViewSlotSharedClientProps,
-  Payload,
-  SanitizedCollectionConfig,
-  StaticDescription,
-  ViewDescriptionClientProps,
-  ViewDescriptionServerPropsOnly,
-} from 'payload'
-
-import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'
-
-type Args = {
-  clientProps: ListViewSlotSharedClientProps
-  collectionConfig: SanitizedCollectionConfig
-  description?: StaticDescription
-  payload: Payload
-  serverProps: FolderListViewServerPropsOnly
-}
-
-export const renderFolderViewSlots = ({
-  clientProps,
-  collectionConfig,
-  description,
-  payload,
-  serverProps,
-}: Args): FolderListViewSlots => {
-  const result: FolderListViewSlots = {} as FolderListViewSlots
-
-  if (collectionConfig.admin.components?.afterList) {
-    result.AfterFolderList = RenderServerComponent({
-      clientProps: clientProps satisfies AfterFolderListClientProps,
-      Component: collectionConfig.admin.components.afterList,
-      importMap: payload.importMap,
-      serverProps: serverProps satisfies AfterFolderListTableServerPropsOnly,
-    })
-  }
-
-  const listMenuItems = collectionConfig.admin.components?.listMenuItems
-  if (Array.isArray(listMenuItems)) {
-    result.listMenuItems = [
-      RenderServerComponent({
-        clientProps,
-        Component: listMenuItems,
-        importMap: payload.importMap,
-        serverProps,
-      }),
-    ]
-  }
-
-  if (collectionConfig.admin.components?.afterListTable) {
-    result.AfterFolderListTable = RenderServerComponent({
-      clientProps: clientProps satisfies AfterFolderListTableClientProps,
-      Component: collectionConfig.admin.components.afterListTable,
-      importMap: payload.importMap,
-      serverProps: serverProps satisfies AfterFolderListTableServerPropsOnly,
-    })
-  }
-
-  if (collectionConfig.admin.components?.beforeList) {
-    result.BeforeFolderList = RenderServerComponent({
-      clientProps: clientProps satisfies BeforeFolderListClientProps,
-      Component: collectionConfig.admin.components.beforeList,
-      importMap: payload.importMap,
-      serverProps: serverProps satisfies BeforeFolderListServerPropsOnly,
-    })
-  }
-
-  if (collectionConfig.admin.components?.beforeListTable) {
-    result.BeforeFolderListTable = RenderServerComponent({
-      clientProps: clientProps satisfies BeforeFolderListTableClientProps,
-      Component: collectionConfig.admin.components.beforeListTable,
-      importMap: payload.importMap,
-      serverProps: serverProps satisfies BeforeFolderListTableServerPropsOnly,
-    })
-  }
-
-  if (collectionConfig.admin.components?.Description) {
-    result.Description = RenderServerComponent({
-      clientProps: {
-        collectionSlug: collectionConfig.slug,
-        description,
-      } satisfies ViewDescriptionClientProps,
-      Component: collectionConfig.admin.components.Description,
-      importMap: payload.importMap,
-      serverProps: serverProps satisfies ViewDescriptionServerPropsOnly,
-    })
-  }
-
-  return result
-}

packages/next/src/views/Document/index.tsx

@@ -32,12 +32,9 @@ import { renderDocumentSlots } from './renderDocumentSlots.js'
 
 export const generateMetadata: GenerateEditViewMetadata = async (args) => getMetaBySegment(args)
 
-/**
- * This function is responsible for rendering
- * an Edit Document view on the server for both:
- *  - default document edit views
- *  - on-demand edit views within drawers
- */
+// This function will be responsible for rendering an Edit Document view
+// it will be called on the server for Edit page views as well as
+// called on-demand from document drawers
 export const renderDocument = async ({
   disableActions,
   documentSubViewType,

packages/next/src/views/List/index.tsx

@@ -40,12 +40,6 @@ type RenderListViewArgs = {
   redirectAfterDuplicate?: boolean
 } & AdminViewServerProps
 
-/**
- * This function is responsible for rendering
- * the list view on the server for both:
- *  - default list view
- *  - list view within drawers
- */
 export const renderListView = async (
   args: RenderListViewArgs,
 ): Promise<{

packages/next/src/views/List/resolveAllFilterOptions.ts

@@ -20,11 +20,7 @@ export const resolveAllFilterOptions = async ({
         return
       }
 
-      if (
-        (field.type === 'relationship' || field.type === 'upload') &&
-        'filterOptions' in field &&
-        field.filterOptions
-      ) {
+      if ('name' in field && 'filterOptions' in field && field.filterOptions) {
         const options = await resolveFilterOptions(field.filterOptions, {
           id: undefined,
           blockData: undefined,

packages/next/src/views/Root/getCustomViewByRoute.ts

@@ -1,6 +1,6 @@
 import type { AdminViewConfig, SanitizedConfig } from 'payload'
 
-import type { ViewFromConfig } from './getRouteData.js'
+import type { ViewFromConfig } from './getViewFromConfig.js'
 
 import { isPathMatchingRoute } from './isPathMatchingRoute.js'
 

packages/next/src/views/Root/getViewFromConfig.ts

@@ -1,6 +1,5 @@
 import type {
   AdminViewServerProps,
-  CollectionSlug,
   DocumentSubViewTypes,
   ImportMap,
   PayloadComponent,
@@ -15,8 +14,6 @@ import { formatAdminURL } from 'payload/shared'
 import type { initPage } from '../../utilities/initPage/index.js'
 
 import { Account } from '../Account/index.js'
-import { BrowseByFolder } from '../BrowseByFolder/index.js'
-import { CollectionFolderView } from '../CollectionFolders/index.js'
 import { CreateFirstUserView } from '../CreateFirstUser/index.js'
 import { Dashboard } from '../Dashboard/index.js'
 import { Document as DocumentView } from '../Document/index.js'
@@ -34,7 +31,6 @@ import { isPathMatchingRoute } from './isPathMatchingRoute.js'
 
 const baseClasses = {
   account: 'account',
-  folders: 'folders',
   forgot: forgotPasswordBaseClass,
   login: loginBaseClass,
   reset: resetPasswordBaseClass,
@@ -52,7 +48,6 @@ export type ViewFromConfig = {
 
 const oneSegmentViews: OneSegmentViews = {
   account: Account,
-  browseByFolder: BrowseByFolder,
   createFirstUser: CreateFirstUserView,
   forgot: ForgotPasswordView,
   inactivity: LogoutInactivity,
@@ -61,7 +56,7 @@ const oneSegmentViews: OneSegmentViews = {
   unauthorized: UnauthorizedView,
 }
 
-type GetRouteDataArgs = {
+type GetViewFromConfigArgs = {
   adminRoute: string
   config: SanitizedConfig
   currentRoute: string
@@ -72,11 +67,9 @@ type GetRouteDataArgs = {
   segments: string[]
 }
 
-type GetRouteDataResult = {
+type GetViewFromConfigResult = {
   DefaultView: ViewFromConfig
   documentSubViewType?: DocumentSubViewTypes
-  folderCollectionSlugs: CollectionSlug[]
-  folderID?: string
   initPageOptions: Parameters<typeof initPage>[0]
   serverProps: ServerPropsFromView
   templateClassName: string
@@ -84,20 +77,19 @@ type GetRouteDataResult = {
   viewType?: ViewTypes
 }
 
-export const getRouteData = ({
+export const getViewFromConfig = ({
   adminRoute,
   config,
   currentRoute,
   importMap,
   searchParams,
   segments,
-}: GetRouteDataArgs): GetRouteDataResult => {
+}: GetViewFromConfigArgs): GetViewFromConfigResult => {
   let ViewToRender: ViewFromConfig = null
   let templateClassName: string
   let templateType: 'default' | 'minimal' | undefined
   let documentSubViewType: DocumentSubViewTypes
   let viewType: ViewTypes
-  let folderID: string
 
   const initPageOptions: Parameters<typeof initPage>[0] = {
     config,
@@ -113,13 +105,6 @@ export const getRouteData = ({
   let matchedCollection: SanitizedConfig['collections'][number] = undefined
   let matchedGlobal: SanitizedConfig['globals'][number] = undefined
 
-  const folderCollectionSlugs = config.collections.reduce((acc, { slug, folders }) => {
-    if (folders) {
-      return [...acc, slug]
-    }
-    return acc
-  }, [])
-
   const serverProps: ServerPropsFromView = {
     viewActions: config?.admin?.components?.actions || [],
   }
@@ -168,7 +153,6 @@ export const getRouteData = ({
       if (oneSegmentViews[viewKey]) {
         // --> /account
         // --> /create-first-user
-        // --> /browse-by-folder
         // --> /forgot
         // --> /login
         // --> /logout
@@ -186,11 +170,6 @@ export const getRouteData = ({
           templateType = 'default'
           viewType = 'account'
         }
-
-        if (folderCollectionSlugs.length && viewKey === 'browseByFolder') {
-          templateType = 'default'
-          viewType = 'folders'
-        }
       }
       break
     }
@@ -203,19 +182,9 @@ export const getRouteData = ({
         templateClassName = baseClasses[segmentTwo]
         templateType = 'minimal'
         viewType = 'reset'
-      } else if (
-        folderCollectionSlugs.length &&
-        `/${segmentOne}` === config.admin.routes.browseByFolder
-      ) {
-        // --> /browse-by-folder/:folderID
-        ViewToRender = {
-          Component: oneSegmentViews.browseByFolder,
-        }
-        templateClassName = baseClasses.folders
-        templateType = 'default'
-        viewType = 'folders'
-        folderID = segmentTwo
-      } else if (isCollection && matchedCollection) {
+      }
+
+      if (isCollection && matchedCollection) {
         // --> /collections/:collectionSlug
 
         ViewToRender = {
@@ -260,47 +229,31 @@ export const getRouteData = ({
         templateType = 'minimal'
         viewType = 'verify'
       } else if (isCollection && matchedCollection) {
-        if (
-          segmentThree === config.folders.slug &&
-          folderCollectionSlugs.includes(matchedCollection.slug)
-        ) {
-          // Collection Folder Views
-          // --> /collections/:collectionSlug/:folderCollectionSlug
-          // --> /collections/:collectionSlug/:folderCollectionSlug/:folderID
-          ViewToRender = {
-            Component: CollectionFolderView,
-          }
+        // Custom Views
+        // --> /collections/:collectionSlug/:id
+        // --> /collections/:collectionSlug/:id/api
+        // --> /collections/:collectionSlug/:id/preview
+        // --> /collections/:collectionSlug/:id/versions
+        // --> /collections/:collectionSlug/:id/versions/:versionID
 
-          templateClassName = `collection-folders`
-          templateType = 'default'
-          viewType = 'collection-folders'
-          folderID = segmentFour
-        } else {
-          // Collection Edit Views
-          // --> /collections/:collectionSlug/:id
-          // --> /collections/:collectionSlug/:id/api
-          // --> /collections/:collectionSlug/:id/preview
-          // --> /collections/:collectionSlug/:id/versions
-          // --> /collections/:collectionSlug/:id/versions/:versionID
-          ViewToRender = {
-            Component: DocumentView,
-          }
-
-          templateClassName = `collection-default-edit`
-          templateType = 'default'
-
-          const viewInfo = getDocumentViewInfo([segmentFour, segmentFive])
-          viewType = viewInfo.viewType
-          documentSubViewType = viewInfo.documentSubViewType
-
-          attachViewActions({
-            collectionOrGlobal: matchedCollection,
-            serverProps,
-            viewKeyArg: documentSubViewType,
-          })
+        ViewToRender = {
+          Component: DocumentView,
         }
+
+        templateClassName = `collection-default-edit`
+        templateType = 'default'
+
+        const viewInfo = getDocumentViewInfo([segmentFour, segmentFive])
+        viewType = viewInfo.viewType
+        documentSubViewType = viewInfo.documentSubViewType
+
+        attachViewActions({
+          collectionOrGlobal: matchedCollection,
+          serverProps,
+          viewKeyArg: documentSubViewType,
+        })
       } else if (isGlobal && matchedGlobal) {
-        // Global Edit Views
+        // Custom Views
         // --> /globals/:globalSlug/versions
         // --> /globals/:globalSlug/preview
         // --> /globals/:globalSlug/versions/:versionID
@@ -335,8 +288,6 @@ export const getRouteData = ({
   return {
     DefaultView: ViewToRender,
     documentSubViewType,
-    folderCollectionSlugs,
-    folderID,
     initPageOptions,
     serverProps,
     templateClassName,

packages/next/src/views/Root/index.tsx

@@ -1,23 +1,22 @@
 import type { I18nClient } from '@payloadcms/translations'
 import type { Metadata } from 'next'
+import type {
+  AdminViewClientProps,
+  AdminViewServerPropsOnly,
+  ImportMap,
+  SanitizedConfig,
+} from 'payload'
 
 import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent'
 import { getClientConfig } from '@payloadcms/ui/utilities/getClientConfig'
 import { notFound, redirect } from 'next/navigation.js'
-import {
-  type AdminViewClientProps,
-  type AdminViewServerPropsOnly,
-  type ImportMap,
-  parseDocumentID,
-  type SanitizedConfig,
-} from 'payload'
 import { formatAdminURL } from 'payload/shared'
-import React from 'react'
+import React, { Fragment } from 'react'
 
 import { DefaultTemplate } from '../../templates/Default/index.js'
 import { MinimalTemplate } from '../../templates/Minimal/index.js'
 import { initPage } from '../../utilities/initPage/index.js'
-import { getRouteData } from './getRouteData.js'
+import { getViewFromConfig } from './getViewFromConfig.js'
 
 export type GenerateViewMetadata = (args: {
   config: SanitizedConfig
@@ -65,14 +64,12 @@ export const RootPage = async ({
   const {
     DefaultView,
     documentSubViewType,
-    folderCollectionSlugs,
-    folderID: folderIDParam,
     initPageOptions,
     serverProps,
     templateClassName,
     templateType,
     viewType,
-  } = getRouteData({
+  } = getViewFromConfig({
     adminRoute,
     config,
     currentRoute,
@@ -92,10 +89,6 @@ export const RootPage = async ({
       })
       ?.then((doc) => !!doc))
 
-  /**
-   * This function is responsible for handling the case where the view is not found.
-   * The current route did not match any default views or custom route views.
-   */
   if (!DefaultView?.Component && !DefaultView?.payloadComponent) {
     if (initPageResult?.req?.user) {
       notFound()
@@ -139,20 +132,8 @@ export const RootPage = async ({
     importMap,
   })
 
-  const payload = initPageResult?.req.payload
-  const folderID = parseDocumentID({
-    id: folderIDParam,
-    collectionSlug: payload.config.folders.slug,
-    payload,
-  })
-
   const RenderedView = RenderServerComponent({
-    clientProps: {
-      clientConfig,
-      documentSubViewType,
-      folderCollectionSlugs,
-      viewType,
-    } satisfies AdminViewClientProps,
+    clientProps: { clientConfig, documentSubViewType, viewType } satisfies AdminViewClientProps,
     Component: DefaultView.payloadComponent,
     Fallback: DefaultView.Component,
     importMap,
@@ -160,7 +141,6 @@ export const RootPage = async ({
       ...serverProps,
       clientConfig,
       docID: initPageResult?.docID,
-      folderID,
       i18n: initPageResult?.req.i18n,
       importMap,
       initPageResult,
@@ -171,8 +151,8 @@ export const RootPage = async ({
   })
 
   return (
-    <React.Fragment>
-      {!templateType && <React.Fragment>{RenderedView}</React.Fragment>}
+    <Fragment>
+      {!templateType && <Fragment>{RenderedView}</Fragment>}
       {templateType === 'minimal' && (
         <MinimalTemplate className={templateClassName}>{RenderedView}</MinimalTemplate>
       )}
@@ -202,6 +182,6 @@ export const RootPage = async ({
           {RenderedView}
         </DefaultTemplate>
       )}
-    </React.Fragment>
+    </Fragment>
   )
 }

packages/next/src/views/Root/metadata.ts

@@ -3,8 +3,6 @@ import type { SanitizedConfig } from 'payload'
 
 import { getNextRequestI18n } from '../../utilities/getNextRequestI18n.js'
 import { generateAccountViewMetadata } from '../Account/metadata.js'
-import { generateBrowseByFolderMetadata } from '../BrowseByFolder/metadata.js'
-import { generateCollectionFolderMetadata } from '../CollectionFolders/metadata.js'
 import { generateCreateFirstUserViewMetadata } from '../CreateFirstUser/metadata.js'
 import { generateDashboardViewMetadata } from '../Dashboard/metadata.js'
 import { generateDocumentViewMetadata } from '../Document/metadata.js'
@@ -20,7 +18,6 @@ import { getCustomViewByRoute } from './getCustomViewByRoute.js'
 
 const oneSegmentMeta = {
   'create-first-user': generateCreateFirstUserViewMetadata,
-  folders: generateBrowseByFolderMetadata,
   forgot: generateForgotPasswordViewMetadata,
   login: generateLoginViewMetadata,
   logout: generateUnauthorizedViewMetadata,
@@ -43,18 +40,12 @@ export const generatePageMetadata = async ({
   params: paramsPromise,
 }: Args) => {
   const config = await configPromise
-  const params = await paramsPromise
 
-  const folderCollectionSlugs = config.collections.reduce((acc, { slug, folders }) => {
-    if (folders) {
-      return [...acc, slug]
-    }
-    return acc
-  }, [])
+  const params = await paramsPromise
   const segments = Array.isArray(params.segments) ? params.segments : []
 
   const currentRoute = `/${segments.join('/')}`
-  const [segmentOne, segmentTwo, segmentThree] = segments
+  const [segmentOne, segmentTwo] = segments
 
   const isGlobal = segmentOne === 'globals'
   const isCollection = segmentOne === 'collections'
@@ -81,14 +72,7 @@ export const generatePageMetadata = async ({
       break
     }
     case 1: {
-      if (folderCollectionSlugs.length && `/${segmentOne}` === config.admin.routes.browseByFolder) {
-        // --> /:folderCollectionSlug
-        meta = await oneSegmentMeta.folders({ config, i18n })
-      } else if (segmentOne === 'account') {
-        // --> /account
-        meta = await generateAccountViewMetadata({ config, i18n })
-        break
-      } else if (oneSegmentMeta[segmentOne]) {
+      if (oneSegmentMeta[segmentOne] && segmentOne !== 'account') {
         // --> /create-first-user
         // --> /forgot
         // --> /login
@@ -97,6 +81,10 @@ export const generatePageMetadata = async ({
         // --> /unauthorized
         meta = await oneSegmentMeta[segmentOne]({ config, i18n })
         break
+      } else if (segmentOne === 'account') {
+        // --> /account
+        meta = await generateAccountViewMetadata({ config, i18n })
+        break
       }
       break
     }
@@ -104,13 +92,8 @@ export const generatePageMetadata = async ({
       if (`/${segmentOne}` === config.admin.routes.reset) {
         // --> /reset/:token
         meta = await generateResetPasswordViewMetadata({ config, i18n })
-      } else if (
-        folderCollectionSlugs.length &&
-        `/${segmentOne}` === config.admin.routes.browseByFolder
-      ) {
-        // --> /browse-by-folder/:folderID
-        meta = await generateBrowseByFolderMetadata({ config, i18n })
-      } else if (isCollection) {
+      }
+      if (isCollection) {
         // --> /collections/:collectionSlug
         meta = await generateListViewMetadata({ collectionConfig, config, i18n })
       } else if (isGlobal) {
@@ -129,29 +112,15 @@ export const generatePageMetadata = async ({
         // --> /:collectionSlug/verify/:token
         meta = await generateVerifyViewMetadata({ config, i18n })
       } else if (isCollection) {
-        if (segmentThree === config.folders.slug) {
-          if (folderCollectionSlugs.includes(collectionConfig.slug)) {
-            // Collection Folder Views
-            // --> /collections/:collectionSlug/:folderCollectionSlug
-            // --> /collections/:collectionSlug/:folderCollectionSlug/:id
-            meta = await generateCollectionFolderMetadata({
-              collectionConfig,
-              config,
-              i18n,
-              params,
-            })
-          }
-        } else {
-          // Collection Document Views
-          // --> /collections/:collectionSlug/:id
-          // --> /collections/:collectionSlug/:id/preview
-          // --> /collections/:collectionSlug/:id/versions
-          // --> /collections/:collectionSlug/:id/versions/:version
-          // --> /collections/:collectionSlug/:id/api
-          meta = await generateDocumentViewMetadata({ collectionConfig, config, i18n, params })
-        }
+        // Custom Views
+        // --> /collections/:collectionSlug/:id
+        // --> /collections/:collectionSlug/:id/preview
+        // --> /collections/:collectionSlug/:id/versions
+        // --> /collections/:collectionSlug/:id/versions/:version
+        // --> /collections/:collectionSlug/:id/api
+        meta = await generateDocumentViewMetadata({ collectionConfig, config, i18n, params })
       } else if (isGlobal) {
-        // Global Document Views
+        // Custom Views
         // --> /globals/:globalSlug/versions
         // --> /globals/:globalSlug/versions/:version
         // --> /globals/:globalSlug/preview

packages/next/src/views/Version/RenderFieldsToDiff/utilities/countChangedFields.ts

@@ -1,6 +1,6 @@
 import type { ArrayFieldClient, BlocksFieldClient, ClientConfig, ClientField } from 'payload'
 
-import { fieldShouldBeLocalized, groupHasName } from 'payload/shared'
+import { fieldShouldBeLocalized } from 'payload/shared'
 
 import { fieldHasChanges } from './fieldHasChanges.js'
 import { getFieldsForRowComparison } from './getFieldsForRowComparison.js'
@@ -114,37 +114,25 @@ export function countChangedFields({
 
       // Fields that have nested fields and nest their fields' data.
       case 'group': {
-        if (groupHasName(field)) {
-          if (locales && fieldShouldBeLocalized({ field, parentIsLocalized })) {
-            locales.forEach((locale) => {
-              count += countChangedFields({
-                comparison: comparison?.[field.name]?.[locale],
-                config,
-                fields: field.fields,
-                locales,
-                parentIsLocalized: parentIsLocalized || field.localized,
-                version: version?.[field.name]?.[locale],
-              })
-            })
-          } else {
+        if (locales && fieldShouldBeLocalized({ field, parentIsLocalized })) {
+          locales.forEach((locale) => {
             count += countChangedFields({
-              comparison: comparison?.[field.name],
+              comparison: comparison?.[field.name]?.[locale],
               config,
               fields: field.fields,
               locales,
               parentIsLocalized: parentIsLocalized || field.localized,
-              version: version?.[field.name],
+              version: version?.[field.name]?.[locale],
             })
-          }
+          })
         } else {
-          // Unnamed group field: data is NOT nested under `field.name`
           count += countChangedFields({
-            comparison,
+            comparison: comparison?.[field.name],
             config,
             fields: field.fields,
             locales,
             parentIsLocalized: parentIsLocalized || field.localized,
-            version,
+            version: version?.[field.name],
           })
         }
         break

packages/next/src/views/Versions/cells/AutosaveCell/index.tsx

@@ -18,11 +18,9 @@ export const renderPill = (data, latestVersion, currentLabel, previousLabel, pil
   return (
     <React.Fragment>
       {data?.id === latestVersion ? (
-        <Pill pillStyle={pillStyle} size="small">
-          {currentLabel}
-        </Pill>
+        <Pill pillStyle={pillStyle}>{currentLabel}</Pill>
       ) : (
-        <Pill size="small">{previousLabel}</Pill>
+        <Pill>{previousLabel}</Pill>
       )}
       &nbsp;&nbsp;
     </React.Fragment>

packages/next/src/withPayload.js

@@ -1,7 +1,7 @@
 /**
  * @param {import('next').NextConfig} nextConfig
- * @param {Object} [sortOnOptions] - Optional configuration options
- * @param {boolean} [sortOnOptions.devBundleServerPackages] - Whether to bundle server packages in development mode. @default true
+ * @param {Object} [options] - Optional configuration options
+ * @param {boolean} [options.devBundleServerPackages] - Whether to bundle server packages in development mode. @default true
  *
  * @returns {import('next').NextConfig}
  * */

packages/payload-cloud/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payloadcms/payload-cloud",
-  "version": "3.39.1",
+  "version": "3.38.0",
   "description": "The official Payload Cloud plugin",
   "homepage": "https://payloadcms.com",
   "repository": {