Ir ao conteúdo
SEED engenhariaDesign System

Composição

4. Como um template se declara — CP13 e CP14

seed-composicao.md v2.1 · §04seção 6 de 1704-como-um-template-se-declara-cp13-e-cp14.md · MD5 ba4ee099

CP13 — A GRAMÁTICA DO TEMPLATE. Um template é a instância nomeada de um arquétipo, e se declara com exatamente cinco campos. Um produto novo tem de conseguir montar a tela lendo a declaração. Slot não declarado não existe: peça fora de slot é drift.

  1. Nome do template.
  2. Arquétipo base (§3) — o contrato de montagem vem dele; o template não redeclara raio, calha nem separação.
  3. Slots — cada um com: nome · tipos de bloco admitidos (CP2) e componentes/blocos de dado aceitos · obrigatório ou opcional · cardinalidade · comportamento <600px.
  4. Exceções nomeadas ao contrato do arquétipo — se não há, o campo diz "nenhuma".
  5. O que o template NÃO decide — conteúdo, copy, quais registros existem: fronteira de produto, declarada para não virar suposição.

Precedente interno exato: o DG1 do seed-dataviz.md — o <figure> de cinco partes (título, descrição, fallback, legenda, área) com obrigatoriedade declarada ("sem as cinco, não é gráfico canônico") é a primeira declaração de slots do DS, e funciona há três sub-blocos. O CP13 generaliza o formato. Alternativa descartada: template como screenshot anotado — não é verificável por suíte nem lível por produto.

CP14 — O PRIMEIRO TEMPLATE DECLARADO: hub-de-tipo (adota o C18 do confronto com as travas que o próprio estudo exige).

Arquétipo base: shell + lista/tabela. Slots:

Slot Bloco/componentes admitidos Obrig. Card. <600px
Título + ação primária faixa; h1 real + botão §1 (máx. 1 primário) sim 1 empilha; botão full-width
Faixa de modelos faixa; cards §26 com ícone §45 não 0–1 rolagem horizontal com fade
Filtros régua; toolbar §42 não 0–1 empilha (TD1)
Coleção peça; tabela §40 ou cards LD2 sim 1 regimes LD2
Vazio vazio §25, tipo conforme a causa (Z1) quando a coleção esvazia 1 herda §25

Exceções ao arquétipo: nenhuma. O template NÃO decide: quais tipos ganham hub, o conteúdo dos modelos, as colunas da coleção.

As duas travas, obrigatórias porque o estudo mediu o custo de não tê-las: (a) a dimensão dominante do tipo é coluna obrigatória e declarada por instância"um hub de contratos quer valor e vencimento em destaque"; colunas idênticas para tipos diferentes significam que nenhum tipo tem a coluna que importa, e num ERP de engenharia quase todo tipo tem dimensão dominante própria. Sem a declaração, o gabarito vira camisa de força e o hub é recusado para aquele tipo. (b) Microcópia flexionada por tipo — o defeito medido do ClickUp ("Marque um Painéis com estrela", "3 pessoa sem tarefas") é concatenação de fragmento com variável não flexionada; a instância declara gênero e plural do tipo.


Esc