@datocms/cma-client 5.5.0-alpha.0 → 5.5.0-alpha.2

package/dist/types/generated/ApiTypes.d.ts

@@ -7747,17 +7747,14 @@ export type Upload = {
      */
     mux_mp4_highest_res: null | 'high' | 'medium' | 'low';
     /**
-     * Per-asset default metadata applied when no record-level overrides are present. `alt`, `title`, and `custom_data` are objects keyed by locale; `focal_point` is non-localized — a single value per asset, applied across every locale (only meaningful for image assets).
-     *
-     * > [!PROTIP] 📘 Requires the `non_localized_focal_points` environment opt-in
-     * > This shape is returned and accepted in environments where the opt-in is active. The opt-in is the path forward and will become the default for all projects. Environments where it is still inactive use a legacy locale-keyed shape under the hood (kept working for compatibility) — opt in to align with this documentation.
+     * Per-asset default metadata applied when no record-level overrides are present. `alt`, `title`, and `custom_data` are objects keyed by locale; `focal_point` is a single value per asset (only meaningful for image assets). See [non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) for more info.
      */
     default_field_metadata: {
         alt: LocalizedAlt;
         title: LocalizedTitle;
         custom_data: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point: {
             /**
@@ -7982,17 +7979,14 @@ export type UploadAttributes = {
      */
     mux_mp4_highest_res: null | 'high' | 'medium' | 'low';
     /**
-     * Per-asset default metadata applied when no record-level overrides are present. `alt`, `title`, and `custom_data` are objects keyed by locale; `focal_point` is non-localized — a single value per asset, applied across every locale (only meaningful for image assets).
-     *
-     * > [!PROTIP] 📘 Requires the `non_localized_focal_points` environment opt-in
-     * > This shape is returned and accepted in environments where the opt-in is active. The opt-in is the path forward and will become the default for all projects. Environments where it is still inactive use a legacy locale-keyed shape under the hood (kept working for compatibility) — opt in to align with this documentation.
+     * Per-asset default metadata applied when no record-level overrides are present. `alt`, `title`, and `custom_data` are objects keyed by locale; `focal_point` is a single value per asset (only meaningful for image assets). See [non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) for more info.
      */
     default_field_metadata: {
         alt: LocalizedAlt;
         title: LocalizedTitle;
         custom_data: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point: {
             /**
@@ -8098,7 +8092,7 @@ export type UploadCreateSchema = {
         title?: LocalizedTitle;
         custom_data?: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point?: {
             /**
@@ -8156,7 +8150,7 @@ export type UploadUpdateSchema = {
         title?: LocalizedTitle;
         custom_data?: LocalizedCustomData;
         /**
-         * Focal point — non-localized; a single value applies across every locale (only meaningful for image assets)
+         * Focal point (only for image assets)
          */
         focal_point?: {
             /**
@@ -10311,32 +10305,125 @@ export type PublicInfo = {
      */
     custom_i18n_messages_template_url: null | string;
     /**
-     * Specifies the color-scheme for the project
+     * Specifies the color-scheme for the project. For monochromatic themes the response only includes type and hue — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
      */
     theme: {
-        primary_color: {
+        /**
+         * Whether the project is using a custom color palette or a monochromatic one derived from a hue.
+         */
+        type: 'custom' | 'monochromatic';
+        /**
+         * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
+         */
+        hue: number | null;
+        /**
+         * An integer color channel value (0-255)
+         */
+        color_channel?: number;
+        /**
+         * An RGBA color value
+         */
+        color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
             [k: string]: unknown;
         };
-        light_color: {
+        /**
+         * An RGBA color value
+         */
+        primary_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        accent_color: {
+        /**
+         * An RGBA color value
+         */
+        light_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        dark_color: {
+        /**
+         * An RGBA color value
+         */
+        accent_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            alpha: number;
+        };
+        /**
+         * An RGBA color value
+         */
+        dark_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
+            red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
     };
@@ -10389,32 +10476,125 @@ export type PublicInfoAttributes = {
      */
     custom_i18n_messages_template_url: null | string;
     /**
-     * Specifies the color-scheme for the project
+     * Specifies the color-scheme for the project. For monochromatic themes the response only includes type and hue — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
      */
     theme: {
-        primary_color: {
+        /**
+         * Whether the project is using a custom color palette or a monochromatic one derived from a hue.
+         */
+        type: 'custom' | 'monochromatic';
+        /**
+         * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
+         */
+        hue: number | null;
+        /**
+         * An integer color channel value (0-255)
+         */
+        color_channel?: number;
+        /**
+         * An RGBA color value
+         */
+        color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
             [k: string]: unknown;
         };
-        light_color: {
+        /**
+         * An RGBA color value
+         */
+        primary_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        accent_color: {
+        /**
+         * An RGBA color value
+         */
+        light_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        dark_color: {
+        /**
+         * An RGBA color value
+         */
+        accent_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            alpha: number;
+        };
+        /**
+         * An RGBA color value
+         */
+        dark_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
+            red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
     };
@@ -10762,7 +10942,7 @@ export type Site = {
         };
     };
     /**
-     * Specifies the theme to use in administrative area
+     * Specifies the theme to use in administrative area. For monochromatic themes the response only includes type, hue, and logo — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
      */
     theme: {
         /**
@@ -10773,28 +10953,113 @@ export type Site = {
          * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
          */
         hue: number | null;
-        primary_color: {
+        /**
+         * An integer color channel value (0-255)
+         */
+        color_channel?: number;
+        /**
+         * An RGBA color value
+         */
+        color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
+            red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            alpha: number;
+        };
+        /**
+         * An RGBA color value
+         */
+        primary_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        light_color: {
+        /**
+         * An RGBA color value
+         */
+        light_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        accent_color: {
+        /**
+         * An RGBA color value
+         */
+        accent_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        dark_color: {
+        /**
+         * An RGBA color value
+         */
+        dark_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
         /**
@@ -10857,6 +11122,7 @@ export type SiteActivateImprovedValidationAtPublishingTargetSchema = Site;
 export type SiteActivateImprovedExposureOfInlineBlocksInCdaTargetSchema = Site;
 export type SiteActivateImprovedItemsListingTargetSchema = Site;
 export type SiteActivateMillisecondsInDatetimeTargetSchema = Site;
+export type SiteActivateNonLocalizedFocalPointsTargetSchema = Site;
 export type SiteUpdateAssetsCdnDefaultSettingsTargetSchema = Site;
 /**
  * Meta attributes
@@ -10914,7 +11180,7 @@ export type SiteMeta = {
      */
     milliseconds_in_datetime: boolean;
     /**
-     * Whether the non-localized focal points opt-in is active for the environment. When active, an upload's `focal_point` is stored once per asset rather than once per locale, and the CMA `default_field_metadata` attribute is exposed in its field-keyed shape (with `alt`/`title`/`custom_data` keyed by locale and a single top-level `focal_point`). When inactive, the CMA continues to accept and return the legacy locale-keyed shape — the single stored focal_point is replicated into every locale entry on read. The CDA's behavior is unaffected: it already returns a single `focalPoint` value.
+     * Whether the [Non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) opt-in product update is active or not
      */
     non_localized_focal_points: boolean;
 };
@@ -11019,7 +11285,7 @@ export type SiteAttributes = {
         };
     };
     /**
-     * Specifies the theme to use in administrative area
+     * Specifies the theme to use in administrative area. For monochromatic themes the response only includes type, hue, and logo — frontends must derive the palette from the hue. For custom themes the primary_color, light_color, accent_color, and dark_color fields are returned.
      */
     theme: {
         /**
@@ -11030,28 +11296,113 @@ export type SiteAttributes = {
          * If the type is monochromatic, the value will fall between 0 and 359. If it's not, the value will be null.
          */
         hue: number | null;
-        primary_color: {
+        /**
+         * An integer color channel value (0-255)
+         */
+        color_channel?: number;
+        /**
+         * An RGBA color value
+         */
+        color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        light_color: {
+        /**
+         * An RGBA color value
+         */
+        primary_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        accent_color: {
+        /**
+         * An RGBA color value
+         */
+        light_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
+            alpha: number;
+        };
+        /**
+         * An RGBA color value
+         */
+        accent_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
+            red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
-        dark_color: {
+        /**
+         * An RGBA color value
+         */
+        dark_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
         /**
@@ -11186,28 +11537,88 @@ export type SiteUpdateSchema = {
          * The upload ID that is used as the logo for the project
          */
         logo: string | null;
+        /**
+         * An RGBA color value
+         */
         primary_color: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
+        /**
+         * An RGBA color value
+         */
         light_color: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
+        /**
+         * An RGBA color value
+         */
         accent_color: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
+        /**
+         * An RGBA color value
+         */
         dark_color?: {
+            /**
+             * An integer color channel value (0-255)
+             */
             red: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             green: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             blue: number;
+            /**
+             * An integer color channel value (0-255)
+             */
             alpha: number;
         };
         [k: string]: unknown;
@@ -11279,7 +11690,7 @@ export type SiteUpdateSchema = {
          */
         milliseconds_in_datetime?: boolean;
         /**
-         * Whether the non-localized focal points opt-in is active for the environment. When active, an upload's `focal_point` is stored once per asset rather than once per locale, and the CMA `default_field_metadata` attribute is exposed in its field-keyed shape (with `alt`/`title`/`custom_data` keyed by locale and a single top-level `focal_point`). When inactive, the CMA continues to accept and return the legacy locale-keyed shape — the single stored focal_point is replicated into every locale entry on read. The CDA's behavior is unaffected: it already returns a single `focalPoint` value.
+         * Whether the [Non-localized focal points](https://www.datocms.com/product-updates/non-localized-focal-points) opt-in product update is active or not
          */
         non_localized_focal_points?: boolean;
     };