@uniformdev/canvas 19.186.4-alpha.3 → 19.187.0

package/dist/index.d.mts

@@ -564,7 +564,7 @@ interface external$j {
                     slots?: {
                         [key: string]: external$j["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -832,12 +832,6 @@ interface external$j {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$j["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -1080,7 +1074,7 @@ interface external$j {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -1299,18 +1293,27 @@ interface external$j {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -1325,7 +1328,61 @@ interface external$j {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$j["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -1822,7 +1879,7 @@ interface components$8 {
             slots?: {
                 [key: string]: components$8["schemas"]["ComponentInstance"][];
             };
-            /** @description The public UUID of the composition */
+            /** @description The ID of the composition */
             _id: string;
             /** @description Slug pattern of this component */
             _slug?: string | null;
@@ -2090,12 +2147,6 @@ interface components$8 {
              * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
              */
             optionalPatternParameter?: boolean;
-            /**
-             * @description Resolve this data resource with draft mode content. TBD
-             *
-             * @enum {string}
-             */
-            dataSourceVariant?: "unpublished";
             variables?: components$8["schemas"]["DataResourceVariables"];
         };
         /** @description Variable values for a data resource */
@@ -2379,7 +2430,7 @@ interface external$i {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -2598,18 +2649,27 @@ interface external$i {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -2624,7 +2684,61 @@ interface external$i {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$i["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -3237,7 +3351,7 @@ interface external$h {
                     slots?: {
                         [key: string]: external$h["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -3505,12 +3619,6 @@ interface external$h {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$h["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -3753,7 +3861,7 @@ interface external$h {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -3972,18 +4080,27 @@ interface external$h {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -3998,7 +4115,61 @@ interface external$h {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$h["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -4753,7 +4924,7 @@ interface external$g {
                     slots?: {
                         [key: string]: external$g["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -5021,12 +5192,6 @@ interface external$g {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$g["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -5269,7 +5434,7 @@ interface external$g {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -5488,18 +5653,27 @@ interface external$g {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -5514,7 +5688,61 @@ interface external$g {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$g["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -5606,7 +5834,11 @@ interface paths$e {
         get: {
             parameters: {
                 query: {
-                    /** Specify multiple entry IDs to fetch */
+                    /**
+                     * Specify one or more entry IDs to fetch.
+                     * When `editions=raw`, this matches on edition IDs or entry IDs and edition resolution is disabled.
+                     * When `versionId` is passed, this parameter is required and must contain only one entry ID.
+                     */
                     entryIDs?: components$7["parameters"]["entryIDs"];
                     /**
                      * Specify a historical entry version ID to fetch (retrieved from the entries-history API).
@@ -5706,6 +5938,20 @@ interface paths$e {
                      * Example: ?search=hello
                      */
                     search?: components$7["parameters"]["search"];
+                    /**
+                     * @deprecated Controls the edition resolution behavior.
+                     *
+                     * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                     *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                     *     Without a locale, the default edition is matched
+                     *
+                     * all: Every edition is returned as a separate row.
+                     *
+                     * raw: the entryIDs parameter targets exact edition/entry IDs and no edition resolution is performed.
+                     *     entryIDs MUST be provided with this option.
+                     *     If versionId is passed, this is always enabled.
+                     */
+                    editions?: components$7["parameters"]["editions"];
                 };
             };
             responses: {
@@ -5774,6 +6020,24 @@ interface paths$e {
                          * @description The stage ID the entry is in on its assigned workflow. When undefined, it is implicitly in the initial stage of the workflow
                          */
                         workflowStageId?: string;
+                        /**
+                         * Format: uuid
+                         * @deprecated
+                         * @description The edition ID. When set, this is a child edition of the entry in _id.
+                         */
+                        editionId?: string;
+                        /**
+                         * @deprecated
+                         * @description The name of the entry or edition as shown in the editions listing.
+                         * Describes the purpose of an edition.
+                         */
+                        editionName?: string;
+                        /**
+                         * @deprecated
+                         * @description The priority of the edition or entry. Higher numbers are higher priority.
+                         * When multiple editions enable the same locale, the highest priority edition is used.
+                         */
+                        editionPriority?: number;
                     };
                 };
             };
@@ -5794,9 +6058,19 @@ interface paths$e {
                     "application/json": {
                         /**
                          * Format: uuid
-                         * @description The ID of the entry to delete
+                         * @description The ID of the entry to delete.
+                         * When editionId is also passed, the entry remains and an edition under it is deleted.
+                         * When editionId is omitted, and the entry has editions, all editions will also be deleted along with the entry.
                          */
                         entryId: string;
+                        /**
+                         * Format: uuid
+                         * @deprecated
+                         * @description The edition ID to delete. When set, this deletes a child edition of the entryId.
+                         * The entry will remain when an edition is deleted.
+                         * If the entry ID is specified as the edition ID, the entry will be deleted _but any other editions will remain_ (this is used for unpublishing).
+                         */
+                        editionId?: string;
                         /**
                          * Format: uuid
                          * @description The ID of the project the entry to delete belongs to
@@ -5831,7 +6105,7 @@ interface components$7 {
             type: string;
             /**
              * Format: uuid
-             * @description The public UUID of the entry
+             * @description The ID of the entry
              */
             _id: string;
             /** @description The name of the entry */
@@ -6016,6 +6290,24 @@ interface components$7 {
              * @enum {string}
              */
             stubType?: "missing" | "tooDeep";
+            /**
+             * Format: uuid
+             * @deprecated
+             * @description The edition ID. When set, this is a child edition of the entry in _id.
+             */
+            editionId?: string;
+            /**
+             * @deprecated
+             * @description The name of the entry or edition as shown in the editions listing.
+             * Describes the purpose of an edition.
+             */
+            editionName?: string;
+            /**
+             * @deprecated
+             * @description The priority of the edition or entry. Higher numbers are higher priority.
+             * When multiple editions enable the same locale, the highest priority edition is used.
+             */
+            editionPriority?: number;
         };
         EntryListResponse: {
             entries: components$7["schemas"]["EntryApiResponse"][];
@@ -6026,7 +6318,11 @@ interface components$7 {
     parameters: {
         /** @description The project the entry/entries are on */
         projectId: string;
-        /** @description Specify multiple entry IDs to fetch */
+        /**
+         * @description Specify one or more entry IDs to fetch.
+         * When `editions=raw`, this matches on edition IDs or entry IDs and edition resolution is disabled.
+         * When `versionId` is passed, this parameter is required and must contain only one entry ID.
+         */
         entryIDs: string[];
         /**
          * @description Specify a historical entry version ID to fetch (retrieved from the entries-history API).
@@ -6129,6 +6425,21 @@ interface components$7 {
          * Example: ?search=hello
          */
         search: string;
+        /**
+         * @deprecated
+         * @description Controls the edition resolution behavior.
+         *
+         * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+         *     When a locale is provided, the edition with the highest priority that enables that locale matches
+         *     Without a locale, the default edition is matched
+         *
+         * all: Every edition is returned as a separate row.
+         *
+         * raw: the entryIDs parameter targets exact edition/entry IDs and no edition resolution is performed.
+         *     entryIDs MUST be provided with this option.
+         *     If versionId is passed, this is always enabled.
+         */
+        editions: "auto" | "all" | "raw";
     };
 }
 interface external$f {
@@ -6590,7 +6901,7 @@ interface external$f {
                     slots?: {
                         [key: string]: external$f["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -6858,12 +7169,6 @@ interface external$f {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$f["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -7106,7 +7411,7 @@ interface external$f {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -7325,18 +7630,27 @@ interface external$f {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -7351,7 +7665,61 @@ interface external$f {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$f["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -7445,6 +7813,8 @@ interface paths$d {
                 query: {
                     /** Specify the entry ID to get history for */
                     entryId: string;
+                    /** @deprecated The edition ID. When set, gets history for a child edition of the entryId. */
+                    editionId?: string;
                     /** The project the entries(s) are on. */
                     projectId: string;
                     /** If a request returns a cursor, pass it in this query parameter to get the next page of results. */
@@ -7934,7 +8304,7 @@ interface external$e {
                     slots?: {
                         [key: string]: external$e["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -8202,12 +8572,6 @@ interface external$e {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$e["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -8450,7 +8814,7 @@ interface external$e {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -8669,18 +9033,27 @@ interface external$e {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -8695,15 +9068,69 @@ interface external$e {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
                     locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
                     /**
-                     * Format: date-time
-                     * @description Date and time the composition was last modified (or created if never modified). Uses ISO-8859-1 formatting and UTC timezone.
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
                      */
-                    modified?: string;
+                    editions?: external$e["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
                 };
-                ProjectMapNodeUpdate: {
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
+                    locales: string[];
+                    /**
+                     * Format: date-time
+                     * @description Date and time the composition was last modified (or created if never modified). Uses ISO-8859-1 formatting and UTC timezone.
+                     */
+                    modified?: string;
+                };
+                ProjectMapNodeUpdate: {
                     /**
                      * Format: uuid
                      * @description The id of the projectMap entry
@@ -9335,7 +9762,7 @@ interface external$d {
                     slots?: {
                         [key: string]: external$d["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -9603,12 +10030,6 @@ interface external$d {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$d["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -9851,7 +10272,7 @@ interface external$d {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -10070,18 +10491,27 @@ interface external$d {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -10096,7 +10526,61 @@ interface external$d {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$d["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -10673,7 +11157,7 @@ interface external$c {
                     slots?: {
                         [key: string]: external$c["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -10941,12 +11425,6 @@ interface external$c {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$c["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -11189,7 +11667,7 @@ interface external$c {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -11408,18 +11886,27 @@ interface external$c {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -11434,7 +11921,61 @@ interface external$c {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$c["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -12046,7 +12587,7 @@ interface external$b {
                     slots?: {
                         [key: string]: external$b["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -12314,12 +12855,6 @@ interface external$b {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$b["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -12562,7 +13097,7 @@ interface external$b {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -12781,18 +13316,27 @@ interface external$b {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -12807,7 +13351,61 @@ interface external$b {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$b["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -13419,7 +14017,7 @@ interface external$a {
                     slots?: {
                         [key: string]: external$a["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -13687,12 +14285,6 @@ interface external$a {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$a["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -13935,7 +14527,7 @@ interface external$a {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -14154,18 +14746,27 @@ interface external$a {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -14180,7 +14781,61 @@ interface external$a {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$a["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -14493,7 +15148,8 @@ interface paths$7 {
                 query: {
                     /**
                      * Specify a single composition ID to fetch. The response will be a single composition.
-                     * This is a primary query parameter and cannot be used with any other primary query parameters
+                     * This is a primary query parameter and cannot be used with any other primary query parameters.
+                     * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                      */
                     compositionId?: components$5["parameters"]["compositionId"];
                     /**
@@ -14508,7 +15164,8 @@ interface paths$7 {
                     versionId?: components$5["parameters"]["versionId"];
                     /**
                      * Specify multiple composition IDs to fetch. The response type will be a list.
-                     * This is a primary query parameter and cannot be used with any other primary query parameters
+                     * This is a primary query parameter and cannot be used with any other primary query parameters.
+                     * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                      */
                     compositionIDs?: components$5["parameters"]["compositionIDs"];
                     /**
@@ -14678,6 +15335,21 @@ interface paths$7 {
                      * Example: ?search=hello
                      */
                     search?: components$5["parameters"]["search"];
+                    /**
+                     * @deprecated Controls the edition resolution behavior.
+                     *
+                     * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                     *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                     *     Without a locale, the default edition is matched
+                     *
+                     * all: Every edition is returned as a separate row.
+                     *     Note: this has no effect when used with compositionId which always returns a single result.
+                     *
+                     * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+                     *     compositionId or compositionIDs MUST be provided with this option.
+                     *     If versionId is passed, this is always enabled.
+                     */
+                    editions?: components$5["parameters"]["editions"];
                 };
             };
             responses: {
@@ -14762,6 +15434,24 @@ interface paths$7 {
                          * @description The stage ID the composition is in within its assigned workflow. If undefined, it is implicitly in the initial stage of the workflow
                          */
                         workflowStageId?: string;
+                        /**
+                         * Format: uuid
+                         * @deprecated
+                         * @description The edition ID. When set, this is a child edition of the composition in _id.
+                         */
+                        editionId?: string;
+                        /**
+                         * @deprecated
+                         * @description The name of the composition or edition as shown in the editions listing.
+                         * Describes the purpose of an edition.
+                         */
+                        editionName?: string;
+                        /**
+                         * @deprecated
+                         * @description The priority of the edition or composition. Higher numbers are higher priority.
+                         * When multiple editions enable the same locale, the highest priority edition is used.
+                         */
+                        editionPriority?: number;
                     };
                 };
             };
@@ -14782,9 +15472,19 @@ interface paths$7 {
                     "application/json": {
                         /**
                          * Format: uuid
-                         * @description The ID of the composition to delete
+                         * @description The ID of the composition to delete.
+                         * When editionId is also passed, the composition remains and an edition under it is deleted.
+                         * When editionId is omitted, and the composition has editions, all editions will also be deleted along with the composition.
                          */
                         compositionId: string;
+                        /**
+                         * Format: uuid
+                         * @deprecated
+                         * @description The edition ID to delete. When set, this deletes a child edition of the compositionId.
+                         * The composition will remain when an edition is deleted.
+                         * If the composition ID is specified as the edition ID, the composition will be deleted _but any other editions will remain_ (this is used for unpublishing).
+                         */
+                        editionId?: string;
                         /**
                          * Format: uuid
                          * @description The ID of the project the composition to delete belongs to
@@ -14875,6 +15575,24 @@ interface components$5 {
             workflowStageId?: string;
             /** @description The full definition of the assigned workflow, if any, including stages, permissions, etc. Returned only when `withWorkflowDefinition` is true */
             workflowDefinition?: external$8["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["WorkflowDefinition"];
+            /**
+             * Format: uuid
+             * @deprecated
+             * @description The edition ID. When set, this is a child edition of the composition in _id.
+             */
+            editionId?: string;
+            /**
+             * @deprecated
+             * @description The name of the composition or edition as shown in the editions listing.
+             * Describes the purpose of an edition.
+             */
+            editionName?: string;
+            /**
+             * @deprecated
+             * @description The priority of the edition or composition. Higher numbers are higher priority.
+             * When multiple editions enable the same locale, the highest priority edition is used.
+             */
+            editionPriority?: number;
         };
         CompositionListResponse: {
             compositions: components$5["schemas"]["CompositionApiResponse"][];
@@ -14887,7 +15605,8 @@ interface components$5 {
         projectId: string;
         /**
          * @description Specify a single composition ID to fetch. The response will be a single composition.
-         * This is a primary query parameter and cannot be used with any other primary query parameters
+         * This is a primary query parameter and cannot be used with any other primary query parameters.
+         * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
          */
         compositionId: string;
         /**
@@ -14897,7 +15616,8 @@ interface components$5 {
         componentId: string;
         /**
          * @description Specify multiple composition IDs to fetch. The response type will be a list.
-         * This is a primary query parameter and cannot be used with any other primary query parameters
+         * This is a primary query parameter and cannot be used with any other primary query parameters.
+         * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
          */
         compositionIDs: string[];
         /**
@@ -15082,6 +15802,22 @@ interface components$5 {
          * Example: ?search=hello
          */
         search: string;
+        /**
+         * @deprecated
+         * @description Controls the edition resolution behavior.
+         *
+         * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+         *     When a locale is provided, the edition with the highest priority that enables that locale matches
+         *     Without a locale, the default edition is matched
+         *
+         * all: Every edition is returned as a separate row.
+         *     Note: this has no effect when used with compositionId which always returns a single result.
+         *
+         * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+         *     compositionId or compositionIDs MUST be provided with this option.
+         *     If versionId is passed, this is always enabled.
+         */
+        editions: "auto" | "all" | "raw";
     };
 }
 interface external$8 {
@@ -15543,7 +16279,7 @@ interface external$8 {
                     slots?: {
                         [key: string]: external$8["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -15811,12 +16547,6 @@ interface external$8 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$8["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -16059,7 +16789,7 @@ interface external$8 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -16278,18 +17008,27 @@ interface external$8 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -16304,7 +17043,61 @@ interface external$8 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$8["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -16398,6 +17191,8 @@ interface paths$6 {
                 query: {
                     /** Specify the composition ID to get history for */
                     compositionId: string;
+                    /** @deprecated The edition ID. When set, gets history for a child edition of the compositionId. */
+                    editionId?: string;
                     /** The project the composition(s) are on */
                     projectId: string;
                     /** If a request returns a cursor, pass it in this query parameter to get the next page of results */
@@ -16887,7 +17682,7 @@ interface external$7 {
                     slots?: {
                         [key: string]: external$7["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -17155,12 +17950,6 @@ interface external$7 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$7["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -17403,7 +18192,7 @@ interface external$7 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -17622,18 +18411,27 @@ interface external$7 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -17648,7 +18446,61 @@ interface external$7 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$7["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -18388,7 +19240,7 @@ interface external$6 {
                     slots?: {
                         [key: string]: external$6["../../../lambda/functions/uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -18656,12 +19508,6 @@ interface external$6 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$6["../../../lambda/functions/uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -18888,7 +19734,8 @@ interface external$6 {
                         query: {
                             /**
                              * Specify a single composition ID to fetch. The response will be a single composition.
-                             * This is a primary query parameter and cannot be used with any other primary query parameters
+                             * This is a primary query parameter and cannot be used with any other primary query parameters.
+                             * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                              */
                             compositionId?: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["parameters"]["compositionId"];
                             /**
@@ -18903,7 +19750,8 @@ interface external$6 {
                             versionId?: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["parameters"]["versionId"];
                             /**
                              * Specify multiple composition IDs to fetch. The response type will be a list.
-                             * This is a primary query parameter and cannot be used with any other primary query parameters
+                             * This is a primary query parameter and cannot be used with any other primary query parameters.
+                             * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                              */
                             compositionIDs?: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["parameters"]["compositionIDs"];
                             /**
@@ -19073,6 +19921,21 @@ interface external$6 {
                              * Example: ?search=hello
                              */
                             search?: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["parameters"]["search"];
+                            /**
+                             * @deprecated Controls the edition resolution behavior.
+                             *
+                             * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                             *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                             *     Without a locale, the default edition is matched
+                             *
+                             * all: Every edition is returned as a separate row.
+                             *     Note: this has no effect when used with compositionId which always returns a single result.
+                             *
+                             * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+                             *     compositionId or compositionIDs MUST be provided with this option.
+                             *     If versionId is passed, this is always enabled.
+                             */
+                            editions?: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["parameters"]["editions"];
                         };
                     };
                     responses: {
@@ -19157,6 +20020,24 @@ interface external$6 {
                                  * @description The stage ID the composition is in within its assigned workflow. If undefined, it is implicitly in the initial stage of the workflow
                                  */
                                 workflowStageId?: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID. When set, this is a child edition of the composition in _id.
+                                 */
+                                editionId?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The name of the composition or edition as shown in the editions listing.
+                                 * Describes the purpose of an edition.
+                                 */
+                                editionName?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The priority of the edition or composition. Higher numbers are higher priority.
+                                 * When multiple editions enable the same locale, the highest priority edition is used.
+                                 */
+                                editionPriority?: number;
                             };
                         };
                     };
@@ -19177,9 +20058,19 @@ interface external$6 {
                             "application/json": {
                                 /**
                                  * Format: uuid
-                                 * @description The ID of the composition to delete
+                                 * @description The ID of the composition to delete.
+                                 * When editionId is also passed, the composition remains and an edition under it is deleted.
+                                 * When editionId is omitted, and the composition has editions, all editions will also be deleted along with the composition.
+                                 */
+                                compositionId: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID to delete. When set, this deletes a child edition of the compositionId.
+                                 * The composition will remain when an edition is deleted.
+                                 * If the composition ID is specified as the edition ID, the composition will be deleted _but any other editions will remain_ (this is used for unpublishing).
                                  */
-                                compositionId: string;
+                                editionId?: string;
                                 /**
                                  * Format: uuid
                                  * @description The ID of the project the composition to delete belongs to
@@ -19270,6 +20161,24 @@ interface external$6 {
                     workflowStageId?: string;
                     /** @description The full definition of the assigned workflow, if any, including stages, permissions, etc. Returned only when `withWorkflowDefinition` is true */
                     workflowDefinition?: external$6["../../../lambda/functions/uniform-canvas-types.swagger.yml"]["components"]["schemas"]["WorkflowDefinition"];
+                    /**
+                     * Format: uuid
+                     * @deprecated
+                     * @description The edition ID. When set, this is a child edition of the composition in _id.
+                     */
+                    editionId?: string;
+                    /**
+                     * @deprecated
+                     * @description The name of the composition or edition as shown in the editions listing.
+                     * Describes the purpose of an edition.
+                     */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description The priority of the edition or composition. Higher numbers are higher priority.
+                     * When multiple editions enable the same locale, the highest priority edition is used.
+                     */
+                    editionPriority?: number;
                 };
                 CompositionListResponse: {
                     compositions: external$6["../../../lambda/functions/v1-canvas.swagger.yml"]["components"]["schemas"]["CompositionApiResponse"][];
@@ -19282,7 +20191,8 @@ interface external$6 {
                 projectId: string;
                 /**
                  * @description Specify a single composition ID to fetch. The response will be a single composition.
-                 * This is a primary query parameter and cannot be used with any other primary query parameters
+                 * This is a primary query parameter and cannot be used with any other primary query parameters.
+                 * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                  */
                 compositionId: string;
                 /**
@@ -19292,7 +20202,8 @@ interface external$6 {
                 componentId: string;
                 /**
                  * @description Specify multiple composition IDs to fetch. The response type will be a list.
-                 * This is a primary query parameter and cannot be used with any other primary query parameters
+                 * This is a primary query parameter and cannot be used with any other primary query parameters.
+                 * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                  */
                 compositionIDs: string[];
                 /**
@@ -19477,6 +20388,22 @@ interface external$6 {
                  * Example: ?search=hello
                  */
                 search: string;
+                /**
+                 * @deprecated
+                 * @description Controls the edition resolution behavior.
+                 *
+                 * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                 *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                 *     Without a locale, the default edition is matched
+                 *
+                 * all: Every edition is returned as a separate row.
+                 *     Note: this has no effect when used with compositionId which always returns a single result.
+                 *
+                 * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+                 *     compositionId or compositionIDs MUST be provided with this option.
+                 *     If versionId is passed, this is always enabled.
+                 */
+                editions: "auto" | "all" | "raw";
             };
         };
         operations: {};
@@ -19487,7 +20414,11 @@ interface external$6 {
                 get: {
                     parameters: {
                         query: {
-                            /** Specify multiple entry IDs to fetch */
+                            /**
+                             * Specify one or more entry IDs to fetch.
+                             * When `editions=raw`, this matches on edition IDs or entry IDs and edition resolution is disabled.
+                             * When `versionId` is passed, this parameter is required and must contain only one entry ID.
+                             */
                             entryIDs?: external$6["../../../lambda/functions/v1-entries.swagger.yml"]["components"]["parameters"]["entryIDs"];
                             /**
                              * Specify a historical entry version ID to fetch (retrieved from the entries-history API).
@@ -19587,6 +20518,20 @@ interface external$6 {
                              * Example: ?search=hello
                              */
                             search?: external$6["../../../lambda/functions/v1-entries.swagger.yml"]["components"]["parameters"]["search"];
+                            /**
+                             * @deprecated Controls the edition resolution behavior.
+                             *
+                             * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                             *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                             *     Without a locale, the default edition is matched
+                             *
+                             * all: Every edition is returned as a separate row.
+                             *
+                             * raw: the entryIDs parameter targets exact edition/entry IDs and no edition resolution is performed.
+                             *     entryIDs MUST be provided with this option.
+                             *     If versionId is passed, this is always enabled.
+                             */
+                            editions?: external$6["../../../lambda/functions/v1-entries.swagger.yml"]["components"]["parameters"]["editions"];
                         };
                     };
                     responses: {
@@ -19655,6 +20600,24 @@ interface external$6 {
                                  * @description The stage ID the entry is in on its assigned workflow. When undefined, it is implicitly in the initial stage of the workflow
                                  */
                                 workflowStageId?: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID. When set, this is a child edition of the entry in _id.
+                                 */
+                                editionId?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The name of the entry or edition as shown in the editions listing.
+                                 * Describes the purpose of an edition.
+                                 */
+                                editionName?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The priority of the edition or entry. Higher numbers are higher priority.
+                                 * When multiple editions enable the same locale, the highest priority edition is used.
+                                 */
+                                editionPriority?: number;
                             };
                         };
                     };
@@ -19675,9 +20638,19 @@ interface external$6 {
                             "application/json": {
                                 /**
                                  * Format: uuid
-                                 * @description The ID of the entry to delete
+                                 * @description The ID of the entry to delete.
+                                 * When editionId is also passed, the entry remains and an edition under it is deleted.
+                                 * When editionId is omitted, and the entry has editions, all editions will also be deleted along with the entry.
                                  */
                                 entryId: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID to delete. When set, this deletes a child edition of the entryId.
+                                 * The entry will remain when an edition is deleted.
+                                 * If the entry ID is specified as the edition ID, the entry will be deleted _but any other editions will remain_ (this is used for unpublishing).
+                                 */
+                                editionId?: string;
                                 /**
                                  * Format: uuid
                                  * @description The ID of the project the entry to delete belongs to
@@ -19712,7 +20685,7 @@ interface external$6 {
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the entry
+                     * @description The ID of the entry
                      */
                     _id: string;
                     /** @description The name of the entry */
@@ -19897,6 +20870,24 @@ interface external$6 {
                      * @enum {string}
                      */
                     stubType?: "missing" | "tooDeep";
+                    /**
+                     * Format: uuid
+                     * @deprecated
+                     * @description The edition ID. When set, this is a child edition of the entry in _id.
+                     */
+                    editionId?: string;
+                    /**
+                     * @deprecated
+                     * @description The name of the entry or edition as shown in the editions listing.
+                     * Describes the purpose of an edition.
+                     */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description The priority of the edition or entry. Higher numbers are higher priority.
+                     * When multiple editions enable the same locale, the highest priority edition is used.
+                     */
+                    editionPriority?: number;
                 };
                 EntryListResponse: {
                     entries: external$6["../../../lambda/functions/v1-entries.swagger.yml"]["components"]["schemas"]["EntryApiResponse"][];
@@ -19907,7 +20898,11 @@ interface external$6 {
             parameters: {
                 /** @description The project the entry/entries are on */
                 projectId: string;
-                /** @description Specify multiple entry IDs to fetch */
+                /**
+                 * @description Specify one or more entry IDs to fetch.
+                 * When `editions=raw`, this matches on edition IDs or entry IDs and edition resolution is disabled.
+                 * When `versionId` is passed, this parameter is required and must contain only one entry ID.
+                 */
                 entryIDs: string[];
                 /**
                  * @description Specify a historical entry version ID to fetch (retrieved from the entries-history API).
@@ -20010,6 +21005,21 @@ interface external$6 {
                  * Example: ?search=hello
                  */
                 search: string;
+                /**
+                 * @deprecated
+                 * @description Controls the edition resolution behavior.
+                 *
+                 * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                 *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                 *     Without a locale, the default edition is matched
+                 *
+                 * all: Every edition is returned as a separate row.
+                 *
+                 * raw: the entryIDs parameter targets exact edition/entry IDs and no edition resolution is performed.
+                 *     entryIDs MUST be provided with this option.
+                 *     If versionId is passed, this is always enabled.
+                 */
+                editions: "auto" | "all" | "raw";
             };
         };
         operations: {};
@@ -20038,7 +21048,7 @@ interface external$6 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -20257,18 +21267,27 @@ interface external$6 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -20283,7 +21302,61 @@ interface external$6 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$6["../../../lambda/functions/v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -21453,7 +22526,7 @@ interface external$5 {
                     slots?: {
                         [key: string]: external$5["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -21721,12 +22794,6 @@ interface external$5 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$5["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -21953,7 +23020,8 @@ interface external$5 {
                         query: {
                             /**
                              * Specify a single composition ID to fetch. The response will be a single composition.
-                             * This is a primary query parameter and cannot be used with any other primary query parameters
+                             * This is a primary query parameter and cannot be used with any other primary query parameters.
+                             * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                              */
                             compositionId?: external$5["v1-canvas.swagger.yml"]["components"]["parameters"]["compositionId"];
                             /**
@@ -21968,7 +23036,8 @@ interface external$5 {
                             versionId?: external$5["v1-canvas.swagger.yml"]["components"]["parameters"]["versionId"];
                             /**
                              * Specify multiple composition IDs to fetch. The response type will be a list.
-                             * This is a primary query parameter and cannot be used with any other primary query parameters
+                             * This is a primary query parameter and cannot be used with any other primary query parameters.
+                             * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                              */
                             compositionIDs?: external$5["v1-canvas.swagger.yml"]["components"]["parameters"]["compositionIDs"];
                             /**
@@ -22138,6 +23207,21 @@ interface external$5 {
                              * Example: ?search=hello
                              */
                             search?: external$5["v1-canvas.swagger.yml"]["components"]["parameters"]["search"];
+                            /**
+                             * @deprecated Controls the edition resolution behavior.
+                             *
+                             * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                             *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                             *     Without a locale, the default edition is matched
+                             *
+                             * all: Every edition is returned as a separate row.
+                             *     Note: this has no effect when used with compositionId which always returns a single result.
+                             *
+                             * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+                             *     compositionId or compositionIDs MUST be provided with this option.
+                             *     If versionId is passed, this is always enabled.
+                             */
+                            editions?: external$5["v1-canvas.swagger.yml"]["components"]["parameters"]["editions"];
                         };
                     };
                     responses: {
@@ -22222,6 +23306,24 @@ interface external$5 {
                                  * @description The stage ID the composition is in within its assigned workflow. If undefined, it is implicitly in the initial stage of the workflow
                                  */
                                 workflowStageId?: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID. When set, this is a child edition of the composition in _id.
+                                 */
+                                editionId?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The name of the composition or edition as shown in the editions listing.
+                                 * Describes the purpose of an edition.
+                                 */
+                                editionName?: string;
+                                /**
+                                 * @deprecated
+                                 * @description The priority of the edition or composition. Higher numbers are higher priority.
+                                 * When multiple editions enable the same locale, the highest priority edition is used.
+                                 */
+                                editionPriority?: number;
                             };
                         };
                     };
@@ -22242,9 +23344,19 @@ interface external$5 {
                             "application/json": {
                                 /**
                                  * Format: uuid
-                                 * @description The ID of the composition to delete
+                                 * @description The ID of the composition to delete.
+                                 * When editionId is also passed, the composition remains and an edition under it is deleted.
+                                 * When editionId is omitted, and the composition has editions, all editions will also be deleted along with the composition.
                                  */
                                 compositionId: string;
+                                /**
+                                 * Format: uuid
+                                 * @deprecated
+                                 * @description The edition ID to delete. When set, this deletes a child edition of the compositionId.
+                                 * The composition will remain when an edition is deleted.
+                                 * If the composition ID is specified as the edition ID, the composition will be deleted _but any other editions will remain_ (this is used for unpublishing).
+                                 */
+                                editionId?: string;
                                 /**
                                  * Format: uuid
                                  * @description The ID of the project the composition to delete belongs to
@@ -22335,6 +23447,24 @@ interface external$5 {
                     workflowStageId?: string;
                     /** @description The full definition of the assigned workflow, if any, including stages, permissions, etc. Returned only when `withWorkflowDefinition` is true */
                     workflowDefinition?: external$5["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["WorkflowDefinition"];
+                    /**
+                     * Format: uuid
+                     * @deprecated
+                     * @description The edition ID. When set, this is a child edition of the composition in _id.
+                     */
+                    editionId?: string;
+                    /**
+                     * @deprecated
+                     * @description The name of the composition or edition as shown in the editions listing.
+                     * Describes the purpose of an edition.
+                     */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description The priority of the edition or composition. Higher numbers are higher priority.
+                     * When multiple editions enable the same locale, the highest priority edition is used.
+                     */
+                    editionPriority?: number;
                 };
                 CompositionListResponse: {
                     compositions: external$5["v1-canvas.swagger.yml"]["components"]["schemas"]["CompositionApiResponse"][];
@@ -22347,7 +23477,8 @@ interface external$5 {
                 projectId: string;
                 /**
                  * @description Specify a single composition ID to fetch. The response will be a single composition.
-                 * This is a primary query parameter and cannot be used with any other primary query parameters
+                 * This is a primary query parameter and cannot be used with any other primary query parameters.
+                 * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                  */
                 compositionId: string;
                 /**
@@ -22357,7 +23488,8 @@ interface external$5 {
                 componentId: string;
                 /**
                  * @description Specify multiple composition IDs to fetch. The response type will be a list.
-                 * This is a primary query parameter and cannot be used with any other primary query parameters
+                 * This is a primary query parameter and cannot be used with any other primary query parameters.
+                 * When `editions=raw`, this parameter matches on composition or edition IDs and edition resolution is disabled.
                  */
                 compositionIDs: string[];
                 /**
@@ -22542,6 +23674,22 @@ interface external$5 {
                  * Example: ?search=hello
                  */
                 search: string;
+                /**
+                 * @deprecated
+                 * @description Controls the edition resolution behavior.
+                 *
+                 * auto: (default) Editions are evaluated automatically and the best matching edition is returned.
+                 *     When a locale is provided, the edition with the highest priority that enables that locale matches
+                 *     Without a locale, the default edition is matched
+                 *
+                 * all: Every edition is returned as a separate row.
+                 *     Note: this has no effect when used with compositionId which always returns a single result.
+                 *
+                 * raw: the compositionId and compositionIDs parameters target exact edition/composition IDs and no edition resolution is performed.
+                 *     compositionId or compositionIDs MUST be provided with this option.
+                 *     If versionId is passed, this is always enabled.
+                 */
+                editions: "auto" | "all" | "raw";
             };
         };
         operations: {};
@@ -22570,7 +23718,7 @@ interface external$5 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -22789,18 +23937,27 @@ interface external$5 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -22815,7 +23972,61 @@ interface external$5 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$5["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -23228,7 +24439,7 @@ type CanvasDefinitions = {
     workflows?: Array<WorkflowDefinition>;
 };
 /** Defines shared parameters for requests getting a single composition */
-type CompositionGetOneSharedParameters = Pick<CompositionGetParameters, 'state' | 'skipEnhance' | 'skipPatternResolution' | 'withComponentIDs' | 'withUIStatus' | 'withWorkflowDefinition' | 'withProjectMapNodes' | 'withTotalCount' | 'skipOverridesResolution' | 'withContentSourceMap' | 'versionId' | 'locale' | 'releaseId'>;
+type CompositionGetOneSharedParameters = Pick<CompositionGetParameters, 'state' | 'skipEnhance' | 'skipPatternResolution' | 'withComponentIDs' | 'withUIStatus' | 'withWorkflowDefinition' | 'withProjectMapNodes' | 'withTotalCount' | 'skipOverridesResolution' | 'withContentSourceMap' | 'versionId' | 'locale' | 'releaseId' | 'editions'>;
 type CompositionGetBy<RequiredParameters extends keyof CompositionGetParameters> = CompositionGetOneSharedParameters & Required<Pick<CompositionGetParameters, RequiredParameters>>;
 type SpecificProjectMap = {
     projectMapId?: string;
@@ -23827,7 +25038,7 @@ interface paths$3 {
                 };
             };
             responses: {
-                /** Gets a list of all defined releases for a project */
+                /** Gets a list all changes that are part of a release */
                 200: {
                     content: {
                         "application/json": {
@@ -23868,6 +25079,17 @@ interface components$1 {
             /** @description Friendly name of the entity */
             name: string;
             publicId: external$3["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+            /**
+             * Format: uuid
+             * @description The edition ID of the release content underneath its public ID
+             * NOTE: This is only set when the release content references an edition.
+             */
+            editionId?: string;
+            /**
+             * @description The edition name the release content belongs to, if any.
+             * NOTE: This may be set even when the release content refers to a composition/entry.
+             */
+            editionName?: string;
             /**
              * @description Entity type (i.e. composition, entry, asset, ...).
              * NOTE: New values may be added to this list without being considered a breaking API change
@@ -23914,6 +25136,12 @@ interface components$1 {
              */
             projectId: string;
             publicId: external$3["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
+            /**
+             * Format: uuid
+             * @description The edition ID of the release content underneath its public ID
+             * NOTE: This is only required if the release content has an edition ID
+             */
+            editionId?: string;
             /**
              * @description Entity type (i.e. composition, entry, asset, ...).
              * NOTE: New values may be added to this list without being considered a breaking API change.
@@ -24383,7 +25611,7 @@ interface external$3 {
                     slots?: {
                         [key: string]: external$3["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -24651,12 +25879,6 @@ interface external$3 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$3["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -24899,7 +26121,7 @@ interface external$3 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -25118,18 +26340,27 @@ interface external$3 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -25144,7 +26375,61 @@ interface external$3 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$3["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time
@@ -26013,7 +27298,7 @@ interface external$1 {
                     slots?: {
                         [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
                     };
-                    /** @description The public UUID of the composition */
+                    /** @description The ID of the composition */
                     _id: string;
                     /** @description Slug pattern of this component */
                     _slug?: string | null;
@@ -26281,12 +27566,6 @@ interface external$1 {
                      * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
                      */
                     optionalPatternParameter?: boolean;
-                    /**
-                     * @description Resolve this data resource with draft mode content. TBD
-                     *
-                     * @enum {string}
-                     */
-                    dataSourceVariant?: "unpublished";
                     variables?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataResourceVariables"];
                 };
                 /** @description Variable values for a data resource */
@@ -26529,7 +27808,7 @@ interface external$1 {
                             id?: string;
                             /** The path of the root node to retrieve, cannot have both this parameter and `id` */
                             path?: string;
-                            /** Composition id to find associated sitemap nodes for */
+                            /** Composition id to find associated project map node for */
                             compositionId?: string;
                             /** Limit the number or records returned by a number */
                             limit?: number;
@@ -26748,18 +28027,27 @@ interface external$1 {
                      */
                     id?: string;
                 }[];
-                /** @description Basic information about a composition from the context of a project map node */
+                /**
+                 * @description Basic information about the linked composition from the context of a project map node.
+                 * If the linked composition has editions, the editions are included in the `editions` property.
+                 */
                 ProjectMapNodeCompositionData: {
-                    /** @description Type of the composition instance (public_id of its definition) */
+                    /** @description Type of the linked composition (id of its definition) */
                     type: string;
                     /**
                      * Format: uuid
-                     * @description The public UUID of the composition
+                     * @description The UUID of the linked composition
                      */
                     id: string;
-                    /** @description Slug pattern of this composition */
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     * This is only present if the composition has not been published, but an edition has
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of the linked composition or edition */
                     slug?: string | null;
-                    /** @description Friendly name of this composition */
+                    /** @description Friendly name of this composition or edition */
                     name: string;
                     /**
                      * @deprecated
@@ -26774,7 +28062,61 @@ interface external$1 {
                     icon?: string;
                     /** @description Friendly name of this Composition's Definition */
                     typeName?: string;
-                    /** @description List of locales that the composition is available in. If empty, available in all locales */
+                    /**
+                     * @description List of locales that the composition _or any of its editions_ is available in.
+                     * If empty, available in all locales.
+                     */
+                    locales: string[];
+                    /** @description Priority of the composition relative to any editions */
+                    editionPriority?: number;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /**
+                     * @deprecated
+                     * @description List of editions available for this composition. The composition is included in the list, it is the edition
+                     * where the editionID equals the node's compositionID.
+                     */
+                    editions?: external$1["v1-project-map-nodes.swagger.yml"]["components"]["schemas"]["ProjectMapNodeCompositionEditionData"][];
+                };
+                /**
+                 * @deprecated
+                 * @description Basic information about a composition edition from the context of a project map node
+                 */
+                ProjectMapNodeCompositionEditionData: {
+                    /**
+                     * Format: uuid
+                     * @description The UUID of the linked composition
+                     */
+                    id: string;
+                    /** @description Type of the edition instance (public_id of its definition) */
+                    type: string;
+                    /**
+                     * Format: uuid
+                     * @description The edition UUID underneath the linked composition
+                     */
+                    editionId?: string;
+                    /** @description Slug pattern of this edition */
+                    slug?: string | null;
+                    /** @description Friendly name of the linked composition */
+                    name: string;
+                    /** @description Friendly name of the edition */
+                    editionName?: string;
+                    /** @description Priority of the edition */
+                    editionPriority?: number;
+                    /**
+                     * @deprecated
+                     * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withCompositionUIStatus` option is true
+                     * @enum {string}
+                     */
+                    uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
+                    /**
+                     * @description Icon name or URL for the composition edition (e.g. 'screen' or 'https://s3/my-component.jpg')
+                     * @default screen
+                     */
+                    icon?: string;
+                    /** @description Friendly name of this edition's definition */
+                    typeName?: string;
+                    /** @description List of locales that the edition is available in. If empty, available in all locales */
                     locales: string[];
                     /**
                      * Format: date-time