`color_scheme`


type	`color_scheme`
Valor salvo	`string` — ID do esquema em `color_schemes[]` (ex.: `"scheme-light"`)
Obrigatório	`id`, `type`

Propriedades OPTIONAL

label (recomendado no inspetor; o validador não exige), default, info O valor gravado é o id do esquema (onChange(scheme.id)). Se color_schemes estiver vazio, o inspetor não oferece escolha e pede o arquivo de settings.

Pré-requisito

Declare esquemas em config/settings.schema.json:

{
  "color_schemes": [
    {
      "id": "scheme-light",
      "label": "Claro",
      "settings": {
        "color_primary": "#7c3aed",
        "color_background": "#ffffff"
      }
    }
  ],
  "groups": [
    {
      "name": "Esquema",
      "settings": [
        {
          "id": "color_scheme",
          "type": "color_scheme",
          "label": "Esquema global",
          "default": "scheme-light"
        }
      ]
    }
  ]
}

Runtime

A section recebe o ID do esquema, não o objeto completo:

settings.color_scheme // "scheme-light"

Para cores resolvidas, leia theme settings via hooks do SDK ou props de layout — o field type só persiste a referência.

Onde usar

Theme settings (groups[].settings[]) — esquema global da loja
Section settings — section pode escolher qual esquema aplicar localmente