@uniformdev/canvas 20.72.3-alpha.2 → 20.72.3-alpha.5

package/dist/index.d.mts

@@ -3149,8 +3149,99 @@ interface paths$k {
          *     following query parameter conventions which are pattern-validated and
          *     therefore not declared as named parameters:
          *
-         *     * `filters.<field>[<op>]` — content filtering. See product docs for the supported field / operator combinations.
-         *     * `select.<bucket>[<op>]` — data projection. See product docs for available syntax.
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *     * `select.<bucket>[<op>]` — data projection (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to entries matching field values. The
+         *     allowed field names are project-specific — they come from the project's
+         *     content types — which is why `filters.*` parameters are
+         *     pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field: `name`, `slug`, `type`, `created`, `modified`,
+         *       `entityId`, `editionId`, `releaseId`, `patternId`, `creator`,
+         *       `creatorSubject`, `author`, `authorSubject`, `workflowId`,
+         *       `workflowStageId`, `categoryId`, `labels`, `labelGroups`,
+         *       `uiStatus`, or `locale`.
+         *     * An entry field, addressed as `fields.<fieldId>`. Filtering by fields
+         *       requires also filtering to a single content type (e.g.
+         *       `filters.type[eq]=...`).
+         *     * A sub-property of a field for certain field types: content
+         *       references (`fields.<id>.slug|name|type`), links
+         *       (`fields.<id>.type|projectMapNodeId`), and assets
+         *       (`fields.<id>.url|title|description|mediaType`).
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=article` — only entries of type `article`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.type[eq]=article&filters.fields.brandName[match]=adidas` — field filter scoped to one type.
+         *     * `filters.fields.author.slug[eq]=jane-doe` — filter by a referenced entry's slug.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the response by pruning fields and field
+         *     types before values are resolved. The allowed names are project-specific —
+         *     they come from the project's content types — which is why `select.*`
+         *     parameters are pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *
+         *     The composition-oriented `select.slots.*` operators are also accepted but
+         *     have no effect on entry responses (entries have no slots).
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every block in the returned entry,
+         *       and is forwarded into entries resolved through reference fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field or type names are silent no-ops (the entry shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=`) strips every field; `[except]=*`
+         *       is equivalent.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,coverImage` — keep only titles and cover images on every entry in the list.
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.fields[only]=title,seo_*&select.fields[locales]=seo_*` — lean payload keeping all locales on the SEO fields.
          */
         get: {
             parameters: {
@@ -6641,9 +6732,106 @@ interface paths$c {
          *     following query parameter conventions which are pattern-validated and
          *     therefore not declared as named parameters:
          *
-         *     * `filters.<field>[<op>]` — content filtering. See product docs for
-         *       the supported field / operator combinations.
-         *     * `select.<bucket>[<op>]` — data projection. See product docs for available syntax.
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *     * `select.<bucket>[<op>]` — data projection (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to compositions matching field values.
+         *     The allowed field names are project-specific — they come from the
+         *     project's component definitions — which is why `filters.*` parameters
+         *     are pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field: `name`, `slug`, `type`, `created`, `modified`,
+         *       `entityId`, `editionId`, `releaseId`, `patternId`, `creator`,
+         *       `creatorSubject`, `author`, `authorSubject`, `projectMapId`,
+         *       `projectMapNodeId`, `workflowId`, `workflowStageId`, `categoryId`,
+         *       `labels`, `labelGroups`, `uiStatus`, or `locale`.
+         *     * A component parameter, addressed as `parameters.<parameterId>`.
+         *       Filtering by parameters requires also filtering to a single
+         *       composition type (e.g. `filters.type[eq]=...`).
+         *     * A sub-property of a parameter for certain parameter types:
+         *       content references (`parameters.<id>.slug|name|type`), links
+         *       (`parameters.<id>.type|projectMapNodeId`), and assets
+         *       (`parameters.<id>.url|title|description|mediaType`).
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *     * Filters match root compositions only.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=landingPage` — only compositions of type `landingPage`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.type[eq]=landingPage&filters.parameters.audience[in]=b2b,b2c` — parameter filter scoped to one type.
+         *     * `filters.labels[all]=approved,featured` — has both labels.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the response by pruning fields (parameters),
+         *     field types, and slots before values are resolved. The allowed names are
+         *     project-specific — they come from the project's component definitions and
+         *     content types — which is why `select.*` parameters are pattern-validated
+         *     rather than declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields/parameters; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields/parameters; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *     | `select.slots[only]=a,b` | Keep only the named slots. |
+         *     | `select.slots[except]=a,b` | Drop the named slots. |
+         *     | `select.slots[depth]=N` | Limit how many levels of nested components are kept in slots. |
+         *     | `select.slots.<name>[depth]=N` | Depth limit for one specific slot; overrides `slots[depth]`. |
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every component and block in the
+         *       returned tree, and is forwarded into entries resolved through reference
+         *       fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field, slot, or type names are silent no-ops (the tree shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=` or `select.slots[only]=`) strips
+         *       every member of that bucket; `[except]=*` is equivalent.
+         *     * `[depth]` counts nesting within a single fetched tree and resets inside
+         *       referenced entries.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,slug` — keep only titles and slugs, everywhere in the tree.
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.fields[only]=title&select.slots[only]=` — root title only, with all slots flattened.
+         *     * `select.slots[depth]=2&select.fields[only]=label,url` — two levels of nested components, trimmed to `label` and `url`.
          */
         get: {
             parameters: {
@@ -9465,8 +9653,55 @@ interface paths$a {
          * @description Fetches the correct response action for a given route (redirection, composition, not found).
          *
          *     In addition to the named parameters below, this endpoint accepts data projection syntax:
-         *     `select.<bucket>[<op>]` — See product docs for available syntax.
-         *     Projection does not apply to redirect / notFound responses.
+         *     `select.<bucket>[<op>]` — documented below.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the matched composition by pruning fields
+         *     (parameters), field types, and slots before values are resolved. It only
+         *     applies when the route resolves to a composition; redirect and notFound
+         *     responses are returned unchanged. The allowed names are project-specific —
+         *     they come from the project's component definitions and content types —
+         *     which is why `select.*` parameters are pattern-validated rather than
+         *     declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields/parameters; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields/parameters; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *     | `select.slots[only]=a,b` | Keep only the named slots. |
+         *     | `select.slots[except]=a,b` | Drop the named slots. |
+         *     | `select.slots[depth]=N` | Limit how many levels of nested components are kept in slots. |
+         *     | `select.slots.<name>[depth]=N` | Depth limit for one specific slot; overrides `slots[depth]`. |
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every component and block in the
+         *       returned tree, and is forwarded into entries resolved through reference
+         *       fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field, slot, or type names are silent no-ops (the tree shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=` or `select.slots[only]=`) strips
+         *       every member of that bucket; `[except]=*` is equivalent.
+         *     * `[depth]` counts nesting within a single fetched tree and resets inside
+         *       referenced entries.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,slug&select.slots[only]=` — title and slug of the resolved page with all slots flattened (e.g. for breadcrumbs).
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.slots[depth]=2&select.fields[only]=label,url` — two levels of nested components, trimmed to `label` and `url`.
          */
         get: {
             parameters: {

package/dist/index.d.ts

@@ -3149,8 +3149,99 @@ interface paths$k {
          *     following query parameter conventions which are pattern-validated and
          *     therefore not declared as named parameters:
          *
-         *     * `filters.<field>[<op>]` — content filtering. See product docs for the supported field / operator combinations.
-         *     * `select.<bucket>[<op>]` — data projection. See product docs for available syntax.
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *     * `select.<bucket>[<op>]` — data projection (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to entries matching field values. The
+         *     allowed field names are project-specific — they come from the project's
+         *     content types — which is why `filters.*` parameters are
+         *     pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field: `name`, `slug`, `type`, `created`, `modified`,
+         *       `entityId`, `editionId`, `releaseId`, `patternId`, `creator`,
+         *       `creatorSubject`, `author`, `authorSubject`, `workflowId`,
+         *       `workflowStageId`, `categoryId`, `labels`, `labelGroups`,
+         *       `uiStatus`, or `locale`.
+         *     * An entry field, addressed as `fields.<fieldId>`. Filtering by fields
+         *       requires also filtering to a single content type (e.g.
+         *       `filters.type[eq]=...`).
+         *     * A sub-property of a field for certain field types: content
+         *       references (`fields.<id>.slug|name|type`), links
+         *       (`fields.<id>.type|projectMapNodeId`), and assets
+         *       (`fields.<id>.url|title|description|mediaType`).
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=article` — only entries of type `article`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.type[eq]=article&filters.fields.brandName[match]=adidas` — field filter scoped to one type.
+         *     * `filters.fields.author.slug[eq]=jane-doe` — filter by a referenced entry's slug.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the response by pruning fields and field
+         *     types before values are resolved. The allowed names are project-specific —
+         *     they come from the project's content types — which is why `select.*`
+         *     parameters are pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *
+         *     The composition-oriented `select.slots.*` operators are also accepted but
+         *     have no effect on entry responses (entries have no slots).
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every block in the returned entry,
+         *       and is forwarded into entries resolved through reference fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field or type names are silent no-ops (the entry shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=`) strips every field; `[except]=*`
+         *       is equivalent.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,coverImage` — keep only titles and cover images on every entry in the list.
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.fields[only]=title,seo_*&select.fields[locales]=seo_*` — lean payload keeping all locales on the SEO fields.
          */
         get: {
             parameters: {
@@ -6641,9 +6732,106 @@ interface paths$c {
          *     following query parameter conventions which are pattern-validated and
          *     therefore not declared as named parameters:
          *
-         *     * `filters.<field>[<op>]` — content filtering. See product docs for
-         *       the supported field / operator combinations.
-         *     * `select.<bucket>[<op>]` — data projection. See product docs for available syntax.
+         *     * `filters.<field>[<op>]` — content filtering (documented below).
+         *     * `select.<bucket>[<op>]` — data projection (documented below).
+         *
+         *     #### Content filtering (`filters.*`)
+         *
+         *     Filtering narrows list results to compositions matching field values.
+         *     The allowed field names are project-specific — they come from the
+         *     project's component definitions — which is why `filters.*` parameters
+         *     are pattern-validated rather than declared as named parameters.
+         *
+         *     Syntax: `filters.<field>[<operator>]=<value>`. `<field>` is one of:
+         *
+         *     * A system field: `name`, `slug`, `type`, `created`, `modified`,
+         *       `entityId`, `editionId`, `releaseId`, `patternId`, `creator`,
+         *       `creatorSubject`, `author`, `authorSubject`, `projectMapId`,
+         *       `projectMapNodeId`, `workflowId`, `workflowStageId`, `categoryId`,
+         *       `labels`, `labelGroups`, `uiStatus`, or `locale`.
+         *     * A component parameter, addressed as `parameters.<parameterId>`.
+         *       Filtering by parameters requires also filtering to a single
+         *       composition type (e.g. `filters.type[eq]=...`).
+         *     * A sub-property of a parameter for certain parameter types:
+         *       content references (`parameters.<id>.slug|name|type`), links
+         *       (`parameters.<id>.type|projectMapNodeId`), and assets
+         *       (`parameters.<id>.url|title|description|mediaType`).
+         *
+         *     | Operator | Effect |
+         *     |---|---|
+         *     | `[eq]` / `[neq]` | Exact equality / inequality. |
+         *     | `[match]` | Contains (text search) match; text-like fields only. |
+         *     | `[starts]` | Prefix match. Value limited to letters, numbers, `_`, `.`, `-`, and spaces. |
+         *     | `[lt]` / `[lte]` / `[gt]` / `[gte]` | Comparisons for number, date, and datetime fields (including `created` / `modified`). |
+         *     | `[in]` / `[nin]` | Comma-separated list; matches any (OR) / none of the values. |
+         *     | `[all]` | Comma-separated list; list-valued fields (e.g. `labels`, multi-selects) must contain every value (AND). |
+         *     | `[def]` | `true` or `false`; whether the field has a value at all. |
+         *
+         *     Behavior:
+         *
+         *     * Values are single strings, or comma-separated lists for `[in]`,
+         *       `[nin]`, and `[all]`. Dates accept `YYYY-MM-DD` or a full datetime
+         *       string. An empty value is rejected — use `[def]` to test presence.
+         *     * Not every operator is valid for every field; the allowed set depends
+         *       on the field's type. An unsupported combination returns HTTP 400
+         *       with the supported operators listed.
+         *     * Malformed keys, unknown operators, and unknown field names return
+         *       HTTP 400.
+         *     * Filters match root compositions only.
+         *
+         *     Examples:
+         *
+         *     * `filters.type[eq]=landingPage` — only compositions of type `landingPage`.
+         *     * `filters.modified[gte]=2026-01-01` — modified this year.
+         *     * `filters.type[eq]=landingPage&filters.parameters.audience[in]=b2b,b2c` — parameter filter scoped to one type.
+         *     * `filters.labels[all]=approved,featured` — has both labels.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the response by pruning fields (parameters),
+         *     field types, and slots before values are resolved. The allowed names are
+         *     project-specific — they come from the project's component definitions and
+         *     content types — which is why `select.*` parameters are pattern-validated
+         *     rather than declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields/parameters; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields/parameters; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *     | `select.slots[only]=a,b` | Keep only the named slots. |
+         *     | `select.slots[except]=a,b` | Drop the named slots. |
+         *     | `select.slots[depth]=N` | Limit how many levels of nested components are kept in slots. |
+         *     | `select.slots.<name>[depth]=N` | Depth limit for one specific slot; overrides `slots[depth]`. |
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every component and block in the
+         *       returned tree, and is forwarded into entries resolved through reference
+         *       fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field, slot, or type names are silent no-ops (the tree shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=` or `select.slots[only]=`) strips
+         *       every member of that bucket; `[except]=*` is equivalent.
+         *     * `[depth]` counts nesting within a single fetched tree and resets inside
+         *       referenced entries.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,slug` — keep only titles and slugs, everywhere in the tree.
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.fields[only]=title&select.slots[only]=` — root title only, with all slots flattened.
+         *     * `select.slots[depth]=2&select.fields[only]=label,url` — two levels of nested components, trimmed to `label` and `url`.
          */
         get: {
             parameters: {
@@ -9465,8 +9653,55 @@ interface paths$a {
          * @description Fetches the correct response action for a given route (redirection, composition, not found).
          *
          *     In addition to the named parameters below, this endpoint accepts data projection syntax:
-         *     `select.<bucket>[<op>]` — See product docs for available syntax.
-         *     Projection does not apply to redirect / notFound responses.
+         *     `select.<bucket>[<op>]` — documented below.
+         *
+         *     #### Data projection (`select.*`)
+         *
+         *     Projection returns a subset of the matched composition by pruning fields
+         *     (parameters), field types, and slots before values are resolved. It only
+         *     applies when the route resolves to a composition; redirect and notFound
+         *     responses are returned unchanged. The allowed names are project-specific —
+         *     they come from the project's component definitions and content types —
+         *     which is why `select.*` parameters are pattern-validated rather than
+         *     declared as named parameters.
+         *
+         *     Syntax: `select.<bucket>[<operator>]=<value>`. Values are comma-separated
+         *     lists of names. `*` is the only wildcard and matches zero or more
+         *     characters (e.g. `seo_*`).
+         *
+         *     | Parameter | Effect |
+         *     |---|---|
+         *     | `select.fields[only]=a,b` | Keep only the named fields/parameters; drop everything else. |
+         *     | `select.fields[except]=a,b` | Drop the named fields/parameters; keep everything else. |
+         *     | `select.fields[locales]=a,b` | For the named fields that survive filtering, return the full per-locale value map instead of only the requested locale's value. |
+         *     | `select.fields[blockDepth]=N` | Limit how many levels of block field children are kept. `0` removes all block fields; `preserveAll` prevents projection from trimming fields inside block children. |
+         *     | `select.fieldTypes[only]=a,b` | Keep only fields of the named types (type IDs such as `text`, `richText`, `asset`). |
+         *     | `select.fieldTypes[except]=a,b` | Drop fields of the named types. |
+         *     | `select.slots[only]=a,b` | Keep only the named slots. |
+         *     | `select.slots[except]=a,b` | Drop the named slots. |
+         *     | `select.slots[depth]=N` | Limit how many levels of nested components are kept in slots. |
+         *     | `select.slots.<name>[depth]=N` | Depth limit for one specific slot; overrides `slots[depth]`. |
+         *
+         *     Behavior:
+         *
+         *     * Projection applies recursively at every component and block in the
+         *       returned tree, and is forwarded into entries resolved through reference
+         *       fields.
+         *     * When operators combine, all `[only]` sets are intersected first, then
+         *       `[except]` sets are subtracted — exclusion always wins.
+         *     * Unknown field, slot, or type names are silent no-ops (the tree shape is
+         *       preserved; non-matching content is simply absent). Unknown operators
+         *       return HTTP 400.
+         *     * An empty list (`select.fields[only]=` or `select.slots[only]=`) strips
+         *       every member of that bucket; `[except]=*` is equivalent.
+         *     * `[depth]` counts nesting within a single fetched tree and resets inside
+         *       referenced entries.
+         *
+         *     Examples:
+         *
+         *     * `select.fields[only]=title,slug&select.slots[only]=` — title and slug of the resolved page with all slots flattened (e.g. for breadcrumbs).
+         *     * `select.fieldTypes[except]=richText` — everything except rich-text fields.
+         *     * `select.slots[depth]=2&select.fields[only]=label,url` — two levels of nested components, trimmed to `label` and `url`.
          */
         get: {
             parameters: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas",
-  "version": "20.72.3-alpha.2+36e92d30ab",
+  "version": "20.72.3-alpha.5+87cd60cb2e",
   "description": "Common functionality and types for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -36,9 +36,9 @@
     "svix": "1.96.0"
   },
   "dependencies": {
-    "@uniformdev/assets": "20.72.3-alpha.2+36e92d30ab",
-    "@uniformdev/context": "20.72.3-alpha.2+36e92d30ab",
-    "@uniformdev/richtext": "20.72.3-alpha.2+36e92d30ab",
+    "@uniformdev/assets": "20.72.3-alpha.5+87cd60cb2e",
+    "@uniformdev/context": "20.72.3-alpha.5+87cd60cb2e",
+    "@uniformdev/richtext": "20.72.3-alpha.5+87cd60cb2e",
     "immer": "11.1.8",
     "p-limit": "6.2.0",
     "p-retry": "6.2.1",
@@ -50,5 +50,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "36e92d30ab1b97fc68cf16fc22c6f7865ac8ba97"
+  "gitHead": "87cd60cb2eae75aac26c8c51566e66281c3921f9"
 }