@snksergio/design-system 0.32.1 → 0.34.0

package/dist-lib/src/components/index.d.ts

@@ -57,4 +57,8 @@ export type { InputProps, InputVariantProps, InputState } from './shadcn';
 export { InputGroup, InputGroupInput, InputGroupTextarea, InputGroupAddon, InputGroupText, InputGroupButton, } from './shadcn';
 export { inputGroupVariants } from './shadcn';
 export type { InputGroupProps, InputGroupVariantProps, InputGroupInputProps, InputGroupTextareaProps, InputGroupAddonProps, InputGroupAddonAlign, InputGroupTextProps, InputGroupButtonProps, InputGroupState, } from './shadcn';
+export { useBrand, BRANDS } from '../hooks/useBrand';
+export type { Brand, BrandOption, UseBrandOptions } from '../hooks/useBrand';
+export { useTheme } from '../hooks/useTheme';
+export type { Theme } from '../hooks/useTheme';
 //# sourceMappingURL=index.d.ts.map

package/dist-lib/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.ts"],"names":[],"mappings":"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"}

package/dist-lib/src/components/ui/AppShell/app-shell.d.ts

@@ -9,8 +9,9 @@ import { AppShellProps } from './app-shell.types';
  *
  * **Padrão controlled/uncontrolled** pra `menuCollapsed`:
  * - `menuCollapsed` prop → controlled (consumer gerencia state)
- * - `defaultMenuCollapsed` → uncontrolled initial value
- * - Sem nenhum dos dois → uncontrolled, default `false`
+ * - `defaultMenuCollapsed` → uncontrolled initial value (vence a regra responsiva)
+ * - Sem nenhum dos dois → uncontrolled com default **responsivo**: colapsado
+ *   abaixo de 1536px, expandido acima (ver o `useState` do `internalCollapsed`)
  *
  * Todas as outras props são **passthrough 1:1** pros sub-componentes.
  * AppShell não impõe styling ao body além de gap/padding fixos — consumer

package/dist-lib/src/components/ui/AppShell/app-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,EAEvB,QAAQ,EACR,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,WAAW,EAEX,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EAEf,IAAI,EACJ,MAAM,EACN,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EAER,aAAa,EAAE,mBAAmB,EAClC,oBAA4B,EAC5B,oBAAoB,EAEpB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,SAAS,GACV,EAAE,aAAa,2CAqFf;yBA1He,QAAQ"}
+{"version":3,"file":"app-shell.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,QAAQ,CAAC,EAEvB,QAAQ,EACR,sBAAsB,EACtB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,WAAW,EAEX,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,KAAK,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EAEf,IAAI,EACJ,MAAM,EACN,cAAc,EACd,aAAa,EACb,UAAU,EACV,QAAQ,EAER,aAAa,EAAE,mBAAmB,EAClC,oBAAoB,EACpB,oBAAoB,EAEpB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,SAAS,GACV,EAAE,aAAa,2CAgHf;yBArJe,QAAQ"}

package/dist-lib/src/components/ui/AppShell/app-shell.styles.d.ts

@@ -4,8 +4,9 @@
  * Layout 2-column: sidebar à esquerda (fixa, full-height) + main area
  * à direita (Header sticky no topo + body abaixo).
  *
- * Body recebe `gap-gp-4xl` (24px) e `p-pad-6xl` (32px) por design — slot
- * "padronizado" pra todas as telas. Consumer customiza só os filhos.
+ * Body recebe `gap-gp-4xl` (24px) fixo e padding responsivo em 3 patamares
+ * (18 / 24 / 32px — ver `bodyInner`) por design — slot "padronizado" pra todas
+ * as telas. Consumer customiza só os filhos.
  */
 export declare const root: import('tailwind-variants').TVReturnType<{} | {} | {}, undefined, string[], {} | {}, undefined, import('tailwind-variants').TVReturnType<unknown, undefined, string[], unknown, unknown, undefined>>;
 /** Wrapper da área principal (Header + Body). Ocupa o resto do flex row. */
@@ -26,8 +27,24 @@ export declare const body: import('tailwind-variants').TVReturnType<{} | {} | {}
  *   - `fluid`   (default): ocupa 100% da largura disponível (atual)
  *   - `compact`: max-width 1368px (`--container-main-content-max`), centralizado
  *
- * Mobile (<md): padding reduzido pra 18px — telas pequenas precisam respiro
- * mínimo mas não zero (chat/navegação por overlays usam o bodyInner cheio).
+ * Padding por faixa de viewport — 3 patamares, não 2:
+ *
+ *   < 768px   (max-md)   18px  — telas pequenas precisam respiro mínimo mas não
+ *                               zero (chat/navegação por overlays usam o
+ *                               bodyInner cheio).
+ *   768–1535  (max-2xl)  24px  — NOTEBOOK. Até 2026-08-04 esta faixa herdava os
+ *                               32px do desktop: um 1366×768 gastava a mesma
+ *                               moldura de um 4K, com muito menos área útil.
+ *                               O corte é em `2xl` (1536) e não em `xl` (1280)
+ *                               porque 1366 e 1536 são as duas resoluções de
+ *                               notebook dominantes — cortar em `xl` deixaria a
+ *                               1536 de fora justamente onde aperta.
+ *   ≥ 1536px             32px  — desktop, valor original preservado.
+ *
+ * ⚠️ `max-md:` tem que vencer `max-2xl:` abaixo de 768px. Vence por ordem de
+ * fonte: o Tailwind emite as variantes `max-*` em breakpoint DECRESCENTE, então
+ * a regra `max-md` sai depois da `max-2xl` com a mesma especificidade. Medido no
+ * browser nos 3 patamares, não deduzido — é a classe de erro da L-066.
  */
 export declare const bodyInner: import('tailwind-variants').TVReturnType<{
     layout: {

package/dist-lib/src/components/ui/AppShell/app-shell.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS;;;;;IAUlB;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;qDAUL,CAAC"}
+{"version":3,"file":"app-shell.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,sMAKf,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,SAAS;;;;;IAUlB;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;qDAUL,CAAC"}

package/dist-lib/src/components/ui/AppShell/app-shell.types.d.ts

@@ -92,17 +92,27 @@ export type AppShellProps = {
      * interno (uncontrolled) — toggle do header dispara setInternal.
      */
     menuCollapsed?: boolean;
+    /**
+     * Estado inicial do collapse (uncontrolled). **Omitido, o default é responsivo:**
+     * colapsado abaixo de 1536px (mesma fronteira do padding do body), expandido
+     * acima — notebook perde ~200px de largura útil com o painel aberto.
+     *
+     * Passar valor explícito **vence** a regra responsiva, inclusive `false`.
+     * Aplicado só no mount: resize não re-colapsa, pra não brigar com quem abriu o
+     * menu na mão.
+     */
     defaultMenuCollapsed?: boolean;
     onMenuCollapseChange?: (collapsed: boolean) => void;
-    /** Conteúdo do body — o que muda entre telas. Aplicado dentro de slot
-     *  com `gap-gp-4xl p-pad-6xl` (24px gap + 32px padding). */
+    /** Conteúdo do body — o que muda entre telas. Aplicado dentro de slot com
+     *  gap 24px (`gap-gp-4xl`) e padding responsivo em 3 patamares:
+     *  **18px** < 768px · **24px** 768–1535px (notebook) · **32px** ≥ 1536px. */
     children: ReactNode;
     /** ClassName extra no body slot (raro — use só pra ajustes pontuais). */
     bodyClassName?: string;
     /**
      * Em mobile (<md), zera o padding interno do body — útil pra telas que
      * controlam o próprio padding (chat com overlays fullscreen, mapas, etc).
-     * Default: false (padding 18px mobile, 32px desktop).
+     * Default: false (18px mobile · 24px notebook · 32px desktop).
      */
     mobileEdgeToEdge?: boolean;
     /** ClassName extra no root da AppShell (afeta toda a tela). */

package/dist-lib/src/components/ui/AppShell/app-shell.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-shell.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-shell.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/ui/AppShell/app-shell.types.ts"],"names":[],"mappings":"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"}

package/dist-lib/src/hooks/useBrand.d.ts

@@ -1,31 +1,64 @@
 /**
- * Marcas disponíveis. "default" = tema-base (verde iGreen, sem data-theme).
- * "blue" = overlay de teste multi-tema (src/styles/theme/brand-blue.css).
+ * Marcas disponíveis. `default` = tema-base (verde iGreen, sem `data-theme`); as
+ * outras 4 são overlays de cor escopados em `[data-theme="<id>"]`.
  *
- * Novas marcas: gere o overlay (`npm run tokens:brand:<x>`), importe no
- * globals.css e acrescente o id aqui.
+ * Marca nova: gere o overlay (`npm run tokens:brand:<x>`), importe no `globals.css`
+ * e acrescente aqui **e** no `BRANDS` abaixo. As 6 superfícies completas estão em
+ * `.claude/rules/ds-standards.md` §"Sistema multi-marca".
  */
 export type Brand = "default" | "blue" | "green" | "pay" | "vibrant";
-/**
- * Catálogo de marcas — fonte única p/ o seletor (dropdown) e swatches.
- * Nova marca: gere o overlay, importe no globals.css, acrescente aqui e no type.
- */
-export declare const BRANDS: {
+/** Uma entrada de catálogo: o que o seletor precisa pra renderizar a opção. */
+export type BrandOption = {
     id: Brand;
     label: string;
+    /** Cor do swatch no seletor. Aceita qualquer valor CSS de cor. */
     swatch: string;
-}[];
+};
 /**
- * Hook de MARCA — eixo ortogonal ao dark/light (useTheme).
+ * Catálogo COMPLETO — as 5 marcas que o DS publica. É a fonte única do seletor do
+ * showcase e o default do hook.
+ *
+ * ⚠️ Consumidor: só passe este catálogo inteiro se você importou os 5 overlays. Marca
+ * cujo CSS não está no bundle **não faz nada** quando selecionada — `data-theme` com id
+ * sem CSS é no-op silencioso. Se você instalou só um tema, passe um catálogo com ele:
+ * `useBrand({ brands: [{ id: "vibrant", label: "…", swatch: "…" }] })`.
+ */
+export declare const BRANDS: BrandOption[];
+export type UseBrandOptions = {
+    /**
+     * Catálogo que o hook valida e percorre. Default: `BRANDS` (as 5 do DS).
+     *
+     * Passe um subconjunto quando o projeto importou só alguns overlays — o hook usa esta
+     * lista pra validar o valor persistido e pra ciclar no `toggle()`, então id fora dela
+     * é ignorado e cai no fallback. A **primeira** entrada é o fallback.
+     */
+    brands?: BrandOption[];
+};
+/**
+ * Hook de MARCA — eixo ortogonal ao dark/light (`useTheme`).
+ *
+ *   - Aplica `data-theme="<marca>"` no `<html>`. A primeira entrada do catálogo é
+ *     tratada como padrão: se ela for `default`, o atributo é REMOVIDO (o tema-base
+ *     não tem overlay, então `default` = ausência de `data-theme`).
+ *   - Persiste em `localStorage` e sincroniza instâncias (CustomEvent + storage).
+ *   - Marca e dark/light são independentes: o overlay declara os 2 blocos
+ *     (`[data-theme]:not(.dark)` e `.dark[data-theme]`), então os eixos combinam.
+ *
+ * ```tsx
+ * const { brand, brands, setBrand } = useBrand();          // as 5 do DS
+ * const { brand, setBrand } = useBrand({ brands: meus });  // só o que instalei
+ * ```
  *
- *   - Aplica `data-theme="<marca>"` no `<html>` ("default" remove o atributo).
- *   - O CSS overlay ([data-theme="blue"]) sobrescreve só a família `brand`;
- *     dark/light continua via `.dark`, então os dois eixos combinam livremente.
- *   - Persiste em localStorage + sincroniza instâncias (CustomEvent + storage).
+ * ⚠️ Selecionar marca cujo CSS não está no bundle é **no-op silencioso** — o atributo
+ * entra no `<html>` e nenhuma regra casa. Mantenha o catálogo alinhado com os
+ * `@import` do seu CSS de entrada.
  */
-export declare function useBrand(): {
+export declare function useBrand(options?: UseBrandOptions): {
     readonly brand: Brand;
+    readonly brands: BrandOption[];
+    readonly current: BrandOption;
     readonly setBrand: (next: Brand) => void;
     readonly toggle: () => void;
+    readonly isBrand: (value: unknown) => value is Brand;
 };
 //# sourceMappingURL=useBrand.d.ts.map

package/dist-lib/src/hooks/useBrand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBrand.d.ts","sourceRoot":"","sources":["../../../src/hooks/useBrand.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAMhE,CAAC;AAsBF;;;;;;;GAOG;AACH,wBAAgB,QAAQ;;8BAWc,KAAK;;EAoC1C"}
+{"version":3,"file":"useBrand.d.ts","sourceRoot":"","sources":["../../../src/hooks/useBrand.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,KAAK,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAC;AAErE,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,EAAE,WAAW,EAM/B,CAAC;AAMF,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe;;;;8BAkCZ,KAAK;;8BAvB/B,OAAO,KAAG,KAAK,IAAI,KAAK;EA4EnC"}

package/dist-lib/theme/brand-blue.css

@@ -1,10 +1,13 @@
 /**
  * brand-blue.css — Auto-gerado. Não editar manualmente.
  * Overlay de marca escopado (só o DIFF de cor vs. default). Coexiste com o tema-base.
- * Source: tokens/brands/blue/semantic/*.ts
- * Regenerar: npx tsx tokens/transforms/to-brand-overlay.ts blue > src/styles/theme/brand-blue.css
+ * Source (repo do DS): tokens/brands/blue/semantic/*.ts
+ * Regenerar (só no repo do DS): npm run tokens:brand:blue
  *
- * Ative aplicando data-theme="blue" no <html> (ver src/hooks/useBrand.ts).
+ * ATIVAR: importe este arquivo DEPOIS do tailwind-theme.css e ponha
+ * data-theme="blue" no <html>. Sem o atributo nada casa — e não dá erro.
+ * Seletor de marca em runtime: hook `useBrand` do pacote (≥ 0.33.0), ou
+ * setAttribute/removeAttribute na mão ("default" = remover o atributo).
  *
  * Os 2 blocos são MUTUAMENTE EXCLUSIVOS por construção (`:not(.dark)`). No dark,
  * token ausente do bloco dark cai no `.dark` do tema-base de propósito: o diff só

package/dist-lib/theme/brand-green.css

@@ -1,10 +1,13 @@
 /**
  * brand-green.css — Auto-gerado. Não editar manualmente.
  * Overlay de marca escopado (só o DIFF de cor vs. default). Coexiste com o tema-base.
- * Source: tokens/brands/green/semantic/*.ts
- * Regenerar: npx tsx tokens/transforms/to-brand-overlay.ts green > src/styles/theme/brand-green.css
+ * Source (repo do DS): tokens/brands/green/semantic/*.ts
+ * Regenerar (só no repo do DS): npm run tokens:brand:green
  *
- * Ative aplicando data-theme="green" no <html> (ver src/hooks/useBrand.ts).
+ * ATIVAR: importe este arquivo DEPOIS do tailwind-theme.css e ponha
+ * data-theme="green" no <html>. Sem o atributo nada casa — e não dá erro.
+ * Seletor de marca em runtime: hook `useBrand` do pacote (≥ 0.33.0), ou
+ * setAttribute/removeAttribute na mão ("default" = remover o atributo).
  *
  * Os 2 blocos são MUTUAMENTE EXCLUSIVOS por construção (`:not(.dark)`). No dark,
  * token ausente do bloco dark cai no `.dark` do tema-base de propósito: o diff só

package/dist-lib/theme/brand-pay.css

@@ -1,10 +1,13 @@
 /**
  * brand-pay.css — Auto-gerado. Não editar manualmente.
  * Overlay de marca escopado (só o DIFF de cor vs. default). Coexiste com o tema-base.
- * Source: tokens/brands/pay/semantic/*.ts
- * Regenerar: npx tsx tokens/transforms/to-brand-overlay.ts pay > src/styles/theme/brand-pay.css
+ * Source (repo do DS): tokens/brands/pay/semantic/*.ts
+ * Regenerar (só no repo do DS): npm run tokens:brand:pay
  *
- * Ative aplicando data-theme="pay" no <html> (ver src/hooks/useBrand.ts).
+ * ATIVAR: importe este arquivo DEPOIS do tailwind-theme.css e ponha
+ * data-theme="pay" no <html>. Sem o atributo nada casa — e não dá erro.
+ * Seletor de marca em runtime: hook `useBrand` do pacote (≥ 0.33.0), ou
+ * setAttribute/removeAttribute na mão ("default" = remover o atributo).
  *
  * Os 2 blocos são MUTUAMENTE EXCLUSIVOS por construção (`:not(.dark)`). No dark,
  * token ausente do bloco dark cai no `.dark` do tema-base de propósito: o diff só

package/dist-lib/theme/brand-vibrant.css

@@ -1,10 +1,13 @@
 /**
  * brand-vibrant.css — Auto-gerado. Não editar manualmente.
  * Overlay de marca escopado (só o DIFF de cor vs. default). Coexiste com o tema-base.
- * Source: tokens/brands/vibrant/semantic/*.ts
- * Regenerar: npx tsx tokens/transforms/to-brand-overlay.ts vibrant > src/styles/theme/brand-vibrant.css
+ * Source (repo do DS): tokens/brands/vibrant/semantic/*.ts
+ * Regenerar (só no repo do DS): npm run tokens:brand:vibrant
  *
- * Ative aplicando data-theme="vibrant" no <html> (ver src/hooks/useBrand.ts).
+ * ATIVAR: importe este arquivo DEPOIS do tailwind-theme.css e ponha
+ * data-theme="vibrant" no <html>. Sem o atributo nada casa — e não dá erro.
+ * Seletor de marca em runtime: hook `useBrand` do pacote (≥ 0.33.0), ou
+ * setAttribute/removeAttribute na mão ("default" = remover o atributo).
  *
  * Os 2 blocos são MUTUAMENTE EXCLUSIVOS por construção (`:not(.dark)`). No dark,
  * token ausente do bloco dark cai no `.dark` do tema-base de propósito: o diff só

package/dist-lib/theme.css

@@ -1,7 +1,10 @@
 /**
  * tailwind-theme.css — Auto-gerado. Não editar manualmente.
- * Source of truth: tokens/brands/default/semantic/*.ts
- * Regenerar: npx tsx tokens/transforms/to-tailwind-v4.ts > dist/tailwind-theme.css
+ * Source of truth (repo do DS): tokens/brands/default/semantic/*.ts
+ * Regenerar (só no repo do DS): npm run tokens:tw4
+ *
+ * No seu projeto: este arquivo é gerenciado pelo DS — edição some no próximo update.
+ * Customize na composição da tela (props/variantes + classes DS), não nos tokens.
  */
 
 @theme {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snksergio/design-system",
-  "version": "0.32.1",
+  "version": "0.34.0",
   "//distribuicao": "Canal PRIMARIO = registry shadcn (copy-in) + CLI @snksergio/create-design-system; sobe sozinho no merge (Vercel). Canal SECUNDARIO = este pacote npm (@snksergio/design-system), funcional (build:lib gera ESM+CJS+types+theme.css) e publicado por passo MANUAL do mantenedor, entao costuma ficar atras do registry. NAO e depreciado — o texto anterior dizia isso e estava errado. Publish so pelo Passo 7 do .claude/skills/ds-dev/release.md (valida com `npm run lib:verify`, pede o token, publica, revoga). Ver DISTRIBUICAO.md.",
   "description": "iGreen Design System — internal library for SaaS CRM, admin panels and dashboards. React 19 + Tailwind v4 + Shadcn + Radix.",
   "license": "UNLICENSED",
@@ -91,9 +91,11 @@
     "tokens:dtcg": "tsx tokens/transforms/to-dtcg.ts > dist/tokens.tokens.json",
     "tokens:all": "npm run tokens:tw4 && npm run tokens:css && npm run tokens:dtcg",
     "tokens:check": "tsc --noEmit",
+    "brand:check": "node scripts/brand-check.mjs",
+    "brand:contrast": "node scripts/brand-contrast.mjs",
     "registry:stamp": "node scripts/registry-stamp.mjs",
     "registry:build": "npm run examples:drift && npm run tokens:tw4 && npm run registry:stamp && npx shadcn build",
-    "release:check": "node scripts/registry-check.mjs && node scripts/distribution-debt.mjs --ci && node scripts/examples-drift-check.mjs && npm run registry-app:audit",
+    "release:check": "node scripts/registry-check.mjs --ci && node scripts/brand-check.mjs && node scripts/distribution-debt.mjs --ci && node scripts/examples-drift-check.mjs && npm run registry-app:audit",
     "registry-app:audit": "npm audit --audit-level=high --prefix registry-app",
     "distribution:debt": "node scripts/distribution-debt.mjs",
     "lint:styles": "node scripts/lint-styles.mjs --ratchet origin/main",