Contratos data-store

Propósito

Atributos data-store identificam elementos canônicos da loja para apps que não usam Nube SDK — seletores DOM estáveis entre versões patch do tema.

Exemplos

<h1 data-store="product-name-{{ product.id }}">…</h1>
<div data-store="product-price-{{ product.id }}">…</div>
<input type="submit" data-store="product-buy-button" … />
<div data-store="cart-item-{{ item.product.id }}">…</div>

Blocks do editor

<div {{ block | block_attributes }} data-store="heading-block-{{ block.id }}">

Regras

1. Não remover data-store existentes.
2. Se envolver um nó, mantenha o atributo no elemento original.
3. Novos hooks: lower-kebab-case + id da entidade quando aplicável.
4. data-component (quando presente) segue as mesmas regras.

Classes js-*

Contrato com theme/static/js/store.js — renomear quebra comportamento sem erro visível. Trate js-* com o mesmo cuidado que data-store.