@seedgrid/fe-components 2026.11.3 → 2026.11.5

package/dist/ai/seedgrid-components.manifest.json

@@ -3141,6 +3141,15 @@
             "semanticRole": "appearance",
             "bindable": true
           },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Quando false, bloqueia as acoes que mudam estado: ordenacao, selecao de linhas, filtros (global e por coluna), limpar filtros e gerenciador de colunas. Paginacao, rolagem e carga de mais linhas continuam funcionando. Aparencia de desabilitado e aria-disabled.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
           {
             "name": "mobileMode",
             "type": "\"scroll\" | \"cards\"",
@@ -10484,7 +10493,7 @@
             "type": "boolean",
             "required": false,
             "default": false,
-            "description": "Exibe spinner e bloqueia interacao enquanto a acao esta em progresso.",
+            "description": "Exibe spinner e bloqueia o clique. Continua valendo e vence o loading automático do onClick: o loading efetivo é loading ou operação pendente (Promise/Future devolvida pelo onClick).",
             "semanticRole": "behavior",
             "bindable": true
           },
@@ -10515,9 +10524,9 @@
           },
           {
             "name": "onClick",
-            "type": "MouseEventHandler<HTMLButtonElement>",
+            "type": "(event: MouseEvent<HTMLButtonElement>) => unknown",
             "required": false,
-            "description": "Callback disparado quando a acao e executada.",
+            "description": "Clique do botão; pode ser síncrono ou assíncrono. Síncrono (abrir modal, alternar): nada muda. Se DEVOLVER uma Promise/Future, como async () => { await salvar(); } ou () => salvar(), o botão entra em loading sozinho (spinner, desabilitado, aria-busy na web), ignora cliques até terminar (inclusive cliques seguidos antes de a tela atualizar) e volta ao normal ao terminar ou falhar. Protege contra duplo clique e reenvio e ajuda na idempotência da ação na tela (não substitui a chave de idempotência no servidor). Cuidado: a função precisa devolver a operação; com chaves e sem return (ou sem async), como () => { salvar(); } ou () { salvar(); }, não protege; já async () {...} sempre devolve. O erro não é engolido: o botão sai do loading e relança como rejeição não tratada; trate com try/catch dentro do onClick e avise o usuário (sgWhistle.error). Use async só quando a ação puder demorar ou falhar (salvar, enviar, pagar).",
             "semanticRole": "event",
             "bindable": false
           },
@@ -10554,6 +10563,24 @@
             "file": "apps/showcase/src/app/components/sg-button/samples/basico.tsx.sample",
             "kind": "sample"
           },
+          {
+            "id": "auto-loading",
+            "title": "Loading automático com Future",
+            "file": "apps/showcase/src/app/components/sg-button/samples/loading-automatico-com-future.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "sync-vs-async",
+            "title": "onClick síncrono x assíncrono",
+            "file": "apps/showcase/src/app/components/sg-button/samples/onclick-sincrono-x-assincrono.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "async-error",
+            "title": "Tratando erro no onClick assíncrono",
+            "file": "apps/showcase/src/app/components/sg-button/samples/tratando-erro-no-onclick-assincrono.tsx.sample",
+            "kind": "sample"
+          },
           {
             "id": "playground",
             "title": "Playground",
@@ -10581,7 +10608,8 @@
         "preferredUseCases": [
           "Acoes primarias e secundarias em formularios e telas CRUD.",
           "Submit, confirmacao, salvar, cancelar e outras acoes explicitas do usuario.",
-          "Chamadas para acao com feedback visual de loading."
+          "Chamadas para acao com feedback visual de loading.",
+          "Salvar, enviar ou pagar: use onClick assíncrono (async () => { await salvar(); } ou () => salvar()) para o botão entrar em loading sozinho e ignorar duplo clique; acoes instantaneas (abrir modal, alternar) ficam sincronas."
         ],
         "avoidUseCases": [
           "Agrupar conteudo ou estruturar layout; nesses casos prefira SgPanel, SgCard ou SgStack.",
@@ -10603,7 +10631,10 @@
         ],
         "compositionHints": [
           "Combinar com SgInputText e outros campos em formularios.",
-          "Usar dentro de SgPanel ou SgDialog para acoes contextuais."
+          "Usar dentro de SgPanel ou SgDialog para acoes contextuais.",
+          "O onClick precisa DEVOLVER a Promise/Future para o loading automatico funcionar: onClick={() => { salvar(); }} (chaves sem return) nao protege; use () => salvar() ou async () => { await salvar(); }. No Flutter, async () {...} sempre devolve Future; () { salvar(); } nao.",
+          "O botao nao engole o erro do onClick assincrono: sai do loading e relanca como rejeicao nao tratada. Trate com try/catch dentro do onClick e avise o usuario com sgWhistle.error (Flutter: sgWhistle.error(SgWhistleOptions(...))).",
+          "O loading automatico protege a acao na tela (duplo clique/reenvio), mas nao substitui a chave de idempotencia no servidor. A prop loading manual vence: loading efetivo = loading ou operacao pendente."
         ],
         "rankingSignals": {
           "freeText": 0,
@@ -18099,6 +18130,15 @@
             "semanticRole": "behavior",
             "bindable": true
           },
+          {
+            "name": "overflow",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "description": "Move para um menu '...' os botoes que nao cabem na largura disponivel; abaixo de 600px abre como painel inferior.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
           {
             "name": "children",
             "type": "ReactNode",
@@ -18542,6 +18582,15 @@
             "semanticRole": "behavior",
             "bindable": true
           },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Quando false, o wizard inteiro fica desabilitado: Anterior, Proximo, Concluir e os passos do stepper deixam de responder; a etapa atual segue visivel. Diferente de nextDisabled, que so bloqueia o avanco.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
           {
             "name": "onStepChange",
             "type": "(index: number) => void",
@@ -18901,6 +18950,15 @@
             "semanticRole": "validation",
             "bindable": true
           },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Quando false, os dias, os botoes de mes anterior/proximo e o atalho hoje ficam desabilitados (nao focaveis); a data e o mes atuais continuam legiveis.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
           {
             "name": "onValueChange",
             "type": "(date: Date) => void",
@@ -19087,13 +19145,21 @@
           },
           {
             "name": "digitalStyle",
-            "type": "\"default\" | \"segment\" | \"sevenSegment\" | \"roller3d\" | \"flip\" | \"fade\" | \"matrix\" | \"neon\" | \"discard\"",
+            "type": "\"default\" | \"segment\" | \"sevenSegment\" | \"roller3d\" | \"flip\" | \"fade\" | \"matrix\" | \"neon\" | \"discard\" | \"custom\"",
             "required": false,
             "default": "default",
             "description": "Estilo visual do relogio digital.",
             "semanticRole": "appearance",
             "bindable": true
           },
+          {
+            "name": "digitBuilder",
+            "type": "(parts: SgClockDigitalParts) => ReactNode",
+            "required": false,
+            "description": "Desenha o relogio digital quando digitalStyle e custom; sem ele, usa o estilo default.",
+            "semanticRole": "appearance",
+            "bindable": false
+          },
           {
             "name": "timezone",
             "type": "string",
@@ -23718,20 +23784,38 @@
         "examples": [
           {
             "id": "basic",
-            "title": "Uso basico",
+            "title": "Uso básico",
             "file": "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/uso-basico.tsx.sample",
             "kind": "sample"
           },
           {
             "id": "dynamic",
-            "title": "Troca dinamica de locale",
+            "title": "Troca dinâmica de locale",
             "file": "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/troca-dinamica-de-locale.tsx.sample",
             "kind": "sample"
+          },
+          {
+            "id": "global",
+            "title": "API imperativa (setComponentsI18n)",
+            "file": "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/api-imperativa-setcomponentsi18n.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "custom",
+            "title": "Sobrescrita de mensagens",
+            "file": "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/sobrescrita-de-mensagens.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/providers/sg-components-i18n-provider/sg-components-i18n-provider.tsx.playground",
+            "kind": "playground"
           }
         ],
         "showcase": {
           "route": "/components/providers/sg-components-i18n-provider",
-          "hasPlayground": false,
+          "hasPlayground": true,
           "hasPropsTable": true
         },
         "sdui": {
@@ -23843,14 +23927,20 @@
           },
           {
             "id": "locale-aware",
-            "title": "Componentes conscientes do locale",
+            "title": "Construindo componentes cientes de locale",
             "file": "apps/showcase/src/app/components/hooks/use-components-i18n/samples/componentes-conscientes-do-locale.tsx.sample",
             "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/hooks/use-components-i18n/use-components-i18n.tsx.playground",
+            "kind": "playground"
           }
         ],
         "showcase": {
           "route": "/components/hooks/use-components-i18n",
-          "hasPlayground": false,
+          "hasPlayground": true,
           "hasPropsTable": true
         }
       },

package/dist/buttons/SgButton.d.ts

@@ -14,7 +14,24 @@ export type SgButtonCustomColors = {
     activeBg?: string;
     ring?: string;
 };
-export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "disabled"> & {
+export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "disabled" | "onClick"> & {
+    /**
+     * Clique do botão. Pode ser síncrono ou assíncrono (`(event) => unknown`).
+     *
+     * - Síncrono (abrir modal, alternar painel): funciona como sempre, nada muda.
+     * - Se DEVOLVER uma Promise (`async () => { await salvar(); }` ou `() => salvar()`), o botão entra em loading
+     *   sozinho (spinner, desabilitado, aria-busy), ignora cliques até terminar (inclusive cliques seguidos antes do
+     *   re-render) e volta ao normal ao terminar ou falhar. Protege contra duplo clique e reenvio e ajuda na
+     *   idempotência da ação na tela (não substitui a chave de idempotência no servidor).
+     * - Cuidado: precisa DEVOLVER a Promise. `onClick={() => { salvar(); }}` (chaves sem return) NÃO protege.
+     * - Erro: o botão não engole o erro (sai do loading e relança como rejeição não tratada). Trate com try/catch
+     *   dentro do onClick e avise o usuário (ex.: `sgWhistle.error`).
+     * - Use async só quando a ação puder demorar ou falhar (salvar, enviar, pagar); ações instantâneas ficam síncronas.
+     * - A prop `loading` manual continua valendo e vence (loading efetivo = `loading` || Promise pendente).
+     *
+     * O retorno é `unknown` só para não quebrar handlers existentes de corpo-expressão (`() => lista.push(x)`).
+     */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => unknown;
     /** Quando false, desabilita o botão. Padrão: true. */
     enabled?: boolean;
     severity?: Severity;
@@ -26,11 +43,31 @@ export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>,
     iconOnly?: boolean;
     leftIcon?: React.ReactNode;
     rightIcon?: React.ReactNode;
+    /** Exibe spinner e bloqueia o clique. Vence o loading automático do onClick: loading efetivo = `loading` || Promise pendente. */
     loading?: boolean;
     customColors?: SgButtonCustomColors;
 };
-export declare function resolveButtonColors(severity: Severity, custom?: SgButtonCustomColors): Required<SgButtonCustomColors>;
-export declare const SgButton: React.ForwardRefExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "disabled" | "color"> & {
+export declare function resolveButtonColors(severity: Severity, custom?: SgButtonCustomColors): Required<SgButtonCustomColors> & {
+    activeFg: string;
+};
+export declare const SgButton: React.ForwardRefExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "disabled" | "color" | "onClick"> & {
+    /**
+     * Clique do botão. Pode ser síncrono ou assíncrono (`(event) => unknown`).
+     *
+     * - Síncrono (abrir modal, alternar painel): funciona como sempre, nada muda.
+     * - Se DEVOLVER uma Promise (`async () => { await salvar(); }` ou `() => salvar()`), o botão entra em loading
+     *   sozinho (spinner, desabilitado, aria-busy), ignora cliques até terminar (inclusive cliques seguidos antes do
+     *   re-render) e volta ao normal ao terminar ou falhar. Protege contra duplo clique e reenvio e ajuda na
+     *   idempotência da ação na tela (não substitui a chave de idempotência no servidor).
+     * - Cuidado: precisa DEVOLVER a Promise. `onClick={() => { salvar(); }}` (chaves sem return) NÃO protege.
+     * - Erro: o botão não engole o erro (sai do loading e relança como rejeição não tratada). Trate com try/catch
+     *   dentro do onClick e avise o usuário (ex.: `sgWhistle.error`).
+     * - Use async só quando a ação puder demorar ou falhar (salvar, enviar, pagar); ações instantâneas ficam síncronas.
+     * - A prop `loading` manual continua valendo e vence (loading efetivo = `loading` || Promise pendente).
+     *
+     * O retorno é `unknown` só para não quebrar handlers existentes de corpo-expressão (`() => lista.push(x)`).
+     */
+    onClick?: (event: React.MouseEvent<HTMLButtonElement>) => unknown;
     /** Quando false, desabilita o botão. Padrão: true. */
     enabled?: boolean;
     severity?: Severity;
@@ -42,6 +79,7 @@ export declare const SgButton: React.ForwardRefExoticComponent<Omit<React.Button
     iconOnly?: boolean;
     leftIcon?: React.ReactNode;
     rightIcon?: React.ReactNode;
+    /** Exibe spinner e bloqueia o clique. Vence o loading automático do onClick: loading efetivo = `loading` || Promise pendente. */
     loading?: boolean;
     customColors?: SgButtonCustomColors;
 } & React.RefAttributes<HTMLButtonElement>>;

package/dist/buttons/SgButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgButton.d.ts","sourceRoot":"","sources":["../../src/buttons/SgButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,QAAQ,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,CAAC;AAEb,KAAK,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/B,KAAK,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtC,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG;IACtG,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAsEF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,QAAQ,CAAC,oBAAoB,CAAC,CAYhC;AAoDD,eAAO,MAAM,QAAQ;IAtJnB,sDAAsD;cAC5C,OAAO;eACN,QAAQ;iBACN,UAAU;WAChB,IAAI;YACH,KAAK;gBACD,SAAS;YACb,KAAK,CAAC,SAAS;eACZ,OAAO;eACP,KAAK,CAAC,SAAS;gBACd,KAAK,CAAC,SAAS;cACjB,OAAO;mBACF,oBAAoB;2CAmNpC,CAAC"}
+{"version":3,"file":"SgButton.d.ts","sourceRoot":"","sources":["../../src/buttons/SgButton.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,KAAK,QAAQ,GACT,SAAS,GACT,WAAW,GACX,SAAS,GACT,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,CAAC;AAEb,KAAK,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEhD,KAAK,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/B,KAAK,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtC,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG;IAClH;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC;IAClE,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,iIAAiI;IACjI,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,oBAAoB,CAAC;CACrC,CAAC;AAoFF,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,oBAAoB,GAC5B,QAAQ,CAAC,oBAAoB,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAcvD;AAqDD,eAAO,MAAM,QAAQ;IAzLnB;;;;;;;;;;;;;;;OAeG;cACO,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,OAAO;IACjE,sDAAsD;cAC5C,OAAO;eACN,QAAQ;iBACN,UAAU;WAChB,IAAI;YACH,KAAK;gBACD,SAAS;YACb,KAAK,CAAC,SAAS;eACZ,OAAO;eACP,KAAK,CAAC,SAAS;gBACd,KAAK,CAAC,SAAS;IAC3B,iIAAiI;cACvH,OAAO;mBACF,oBAAoB;2CAsQpC,CAAC"}

package/dist/buttons/SgButton.js

@@ -10,6 +10,8 @@ const PRESET = {
         fg: "var(--sg-btn-primary-fg, hsl(var(--primary-foreground)))",
         border: "var(--sg-btn-primary-border, hsl(var(--primary)))",
         hoverBg: "var(--sg-btn-primary-hover-bg, hsl(var(--primary)))",
+        hoverFg: "var(--sg-btn-primary-hover-fg, var(--sg-btn-primary-fg, hsl(var(--primary-foreground))))",
+        activeFg: "var(--sg-btn-primary-active-fg, var(--sg-btn-primary-fg, hsl(var(--primary-foreground))))",
         ring: "var(--sg-btn-primary-ring, hsl(var(--primary)/0.35))"
     },
     secondary: {
@@ -17,6 +19,8 @@ const PRESET = {
         fg: "var(--sg-btn-secondary-fg, hsl(var(--secondary-foreground)))",
         border: "var(--sg-btn-secondary-border, hsl(var(--secondary)))",
         hoverBg: "var(--sg-btn-secondary-hover-bg, hsl(var(--secondary)))",
+        hoverFg: "var(--sg-btn-secondary-hover-fg, var(--sg-btn-secondary-fg, hsl(var(--secondary-foreground))))",
+        activeFg: "var(--sg-btn-secondary-active-fg, var(--sg-btn-secondary-fg, hsl(var(--secondary-foreground))))",
         ring: "var(--sg-btn-secondary-ring, hsl(var(--secondary)/0.35))"
     },
     success: {
@@ -24,6 +28,8 @@ const PRESET = {
         fg: "var(--sg-btn-success-fg, hsl(var(--tertiary-foreground, var(--accent-foreground, 0 0% 100%))))",
         border: "var(--sg-btn-success-border, hsl(var(--tertiary, var(--accent))))",
         hoverBg: "var(--sg-btn-success-hover-bg, hsl(var(--tertiary, var(--accent))))",
+        hoverFg: "var(--sg-btn-success-hover-fg, var(--sg-btn-success-fg, hsl(var(--tertiary-foreground, var(--accent-foreground, 0 0% 100%)))))",
+        activeFg: "var(--sg-btn-success-active-fg, var(--sg-btn-success-fg, hsl(var(--tertiary-foreground, var(--accent-foreground, 0 0% 100%)))))",
         ring: "var(--sg-btn-success-ring, hsl(var(--tertiary, var(--accent))/0.35))"
     },
     info: {
@@ -31,6 +37,8 @@ const PRESET = {
         fg: "var(--sg-btn-info-fg, hsl(var(--secondary-foreground, var(--primary-foreground))))",
         border: "var(--sg-btn-info-border, hsl(var(--secondary, var(--primary))))",
         hoverBg: "var(--sg-btn-info-hover-bg, hsl(var(--secondary, var(--primary))))",
+        hoverFg: "var(--sg-btn-info-hover-fg, var(--sg-btn-info-fg, hsl(var(--secondary-foreground, var(--primary-foreground)))))",
+        activeFg: "var(--sg-btn-info-active-fg, var(--sg-btn-info-fg, hsl(var(--secondary-foreground, var(--primary-foreground)))))",
         ring: "var(--sg-btn-info-ring, hsl(var(--secondary, var(--primary))/0.35))"
     },
     warning: {
@@ -38,6 +46,8 @@ const PRESET = {
         fg: "var(--sg-btn-warning-fg, hsl(var(--secondary-foreground, var(--accent-foreground, 0 0% 100%))))",
         border: "var(--sg-btn-warning-border, hsl(var(--secondary, var(--accent))))",
         hoverBg: "var(--sg-btn-warning-hover-bg, hsl(var(--secondary, var(--accent))))",
+        hoverFg: "var(--sg-btn-warning-hover-fg, var(--sg-btn-warning-fg, hsl(var(--secondary-foreground, var(--accent-foreground, 0 0% 100%)))))",
+        activeFg: "var(--sg-btn-warning-active-fg, var(--sg-btn-warning-fg, hsl(var(--secondary-foreground, var(--accent-foreground, 0 0% 100%)))))",
         ring: "var(--sg-btn-warning-ring, hsl(var(--secondary, var(--accent))/0.35))"
     },
     help: {
@@ -45,6 +55,8 @@ const PRESET = {
         fg: "var(--sg-btn-help-fg, hsl(var(--secondary-foreground, var(--primary-foreground))))",
         border: "var(--sg-btn-help-border, hsl(var(--secondary, var(--primary))))",
         hoverBg: "var(--sg-btn-help-hover-bg, hsl(var(--secondary, var(--primary))))",
+        hoverFg: "var(--sg-btn-help-hover-fg, var(--sg-btn-help-fg, hsl(var(--secondary-foreground, var(--primary-foreground)))))",
+        activeFg: "var(--sg-btn-help-active-fg, var(--sg-btn-help-fg, hsl(var(--secondary-foreground, var(--primary-foreground)))))",
         ring: "var(--sg-btn-help-ring, hsl(var(--secondary, var(--primary))/0.35))"
     },
     danger: {
@@ -52,6 +64,8 @@ const PRESET = {
         fg: "var(--sg-btn-danger-fg, hsl(var(--destructive-foreground)))",
         border: "var(--sg-btn-danger-border, hsl(var(--destructive)))",
         hoverBg: "var(--sg-btn-danger-hover-bg, hsl(var(--destructive)))",
+        hoverFg: "var(--sg-btn-danger-hover-fg, var(--sg-btn-danger-fg, hsl(var(--destructive-foreground))))",
+        activeFg: "var(--sg-btn-danger-active-fg, var(--sg-btn-danger-fg, hsl(var(--destructive-foreground))))",
         ring: "var(--sg-btn-danger-ring, hsl(var(--destructive)/0.35))"
     },
 };
@@ -67,9 +81,11 @@ export function resolveButtonColors(severity, custom) {
         fg: custom?.fg ?? base.fg,
         border: custom?.border ?? base.border,
         hoverBg: custom?.hoverBg ?? base.hoverBg,
-        hoverFg: custom?.hoverFg ?? (custom?.fg ?? base.fg),
+        // Sem cor customizada, cada estado usa o texto escolhido por contraste sobre o proprio fundo (tokens *-hover-fg/*-active-fg).
+        hoverFg: custom?.hoverFg ?? custom?.fg ?? base.hoverFg,
         hoverBorder: custom?.hoverBorder ?? (custom?.border ?? base.border),
         activeBg: custom?.activeBg ?? (custom?.hoverBg ?? base.hoverBg),
+        activeFg: custom?.hoverFg ?? custom?.fg ?? base.activeFg,
         ring: custom?.ring ?? base.ring
     };
 }
@@ -84,6 +100,7 @@ function buildVars(severity, custom) {
         ["--sg-btn-hover-fg"]: merged.hoverFg,
         ["--sg-btn-hover-border"]: merged.hoverBorder,
         ["--sg-btn-active-bg"]: merged.activeBg,
+        ["--sg-btn-active-fg"]: merged.activeFg,
         ["--sg-btn-ring"]: merged.ring,
         ["--sg-btn-tint"]: `var(--sg-${toneKey}-600)`
     };
@@ -91,7 +108,7 @@ function buildVars(severity, custom) {
 function appearanceClass(appearance) {
     switch (appearance) {
         case "solid":
-            return cn("bg-[var(--sg-btn-bg)] text-[var(--sg-btn-fg)] border border-[var(--sg-btn-border)]", "hover:bg-[var(--sg-btn-hover-bg)] hover:text-[var(--sg-btn-hover-fg)] hover:border-[var(--sg-btn-hover-border)]", "active:bg-[var(--sg-btn-active-bg)]");
+            return cn("bg-[var(--sg-btn-bg)] text-[var(--sg-btn-fg)] border border-[var(--sg-btn-border)]", "hover:bg-[var(--sg-btn-hover-bg)] hover:text-[var(--sg-btn-hover-fg)] hover:border-[var(--sg-btn-hover-border)]", "active:bg-[var(--sg-btn-active-bg)] active:text-[var(--sg-btn-active-fg)]");
         case "outline":
             return cn("bg-transparent text-[var(--sg-btn-bg)] border border-[var(--sg-btn-border)]", "hover:bg-[rgb(var(--sg-btn-tint)/0.12)]", "active:bg-[rgb(var(--sg-btn-tint)/0.18)]");
         case "ghost":
@@ -108,16 +125,45 @@ function elevationClass(elevation) {
             return "";
     }
 }
-export const SgButton = React.forwardRef(({ severity = "primary", appearance = "solid", size, shape, elevation = "none", label, iconOnly, leftIcon, rightIcon, loading = false, enabled = true, className, children, style, customColors, type = "button", ...rest }, ref) => {
+export const SgButton = React.forwardRef(({ severity = "primary", appearance = "solid", size, shape, elevation = "none", label, iconOnly, leftIcon, rightIcon, loading = false, enabled = true, className, children, style, customColors, type = "button", onClick, ...rest }, ref) => {
+    const [pending, setPending] = React.useState(false);
+    const pendingRef = React.useRef(false);
+    const mountedRef = React.useRef(true);
+    React.useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const isLoading = loading || pending;
+    const handleClick = React.useCallback((event) => {
+        if (!onClick || !enabled || loading || pendingRef.current)
+            return;
+        const result = onClick(event);
+        if (!result || typeof result.then !== "function")
+            return;
+        pendingRef.current = true;
+        setPending(true);
+        const done = () => {
+            pendingRef.current = false;
+            if (mountedRef.current)
+                setPending(false);
+        };
+        // O erro da Promise nao e engolido: segue como rejeicao sem tratamento, como antes.
+        void result.then(done, (error) => {
+            done();
+            throw error;
+        });
+    }, [onClick, enabled, loading]);
     const resolvedChildren = children ?? label;
-    const isDisabled = Boolean(!enabled || loading);
+    const isDisabled = Boolean(!enabled || isLoading);
     const inferredIconOnly = !resolvedChildren && (leftIcon || rightIcon);
     const isIconOnly = iconOnly ?? inferredIconOnly;
     const resolvedSize = size ?? (isIconOnly ? "sm" : "md");
     const resolvedShape = shape ?? (isIconOnly ? "circle" : "default");
     const s = SIZE[resolvedSize];
     const contentClass = cn("inline-flex min-w-0 items-center justify-center", !isIconOnly ? "w-full" : undefined, s.gap);
-    return (_jsx("button", { ref: ref, type: type, disabled: isDisabled, style: { ...buildVars(severity, customColors), ...style }, className: cn("inline-flex min-w-0 max-w-full items-center justify-center select-none whitespace-normal break-words text-center", "font-medium", "transition-[background-color,color,border-color,box-shadow,transform] duration-150", "focus-visible:outline-none focus-visible:ring-4 focus-visible:ring-[var(--sg-btn-ring)]", "disabled:opacity-60 disabled:cursor-not-allowed", isIconOnly ? cn("aspect-square", s.h) : cn(s.minH, s.py, s.px), s.text, resolvedShape === "rounded" ? "rounded-full" : resolvedShape === "circle" ? "rounded-full" : resolvedShape === "square" ? "rounded-none" : s.radius, appearanceClass(appearance), elevationClass(elevation), !isDisabled ? "active:translate-y-[0.5px]" : false, className), ...rest, children: loading ? (_jsxs("span", { className: contentClass, children: [_jsx(Spinner, { className: s.icon }), resolvedChildren ? _jsx("span", { className: "min-w-0 whitespace-normal break-words", children: resolvedChildren }) : null] })) : (_jsxs("span", { className: contentClass, children: [leftIcon ? _jsx("span", { className: cn("shrink-0", s.icon), children: leftIcon }) : null, resolvedChildren ? _jsx("span", { className: "min-w-0 whitespace-normal break-words", children: resolvedChildren }) : null, rightIcon ? _jsx("span", { className: cn("shrink-0", s.icon), children: rightIcon }) : null] })) }));
+    return (_jsx("button", { ref: ref, type: type, disabled: isDisabled, "aria-busy": isLoading ? true : undefined, style: { ...buildVars(severity, customColors), ...style }, className: cn("inline-flex min-w-0 max-w-full items-center justify-center select-none whitespace-normal break-words text-center", "font-medium", "transition-[background-color,color,border-color,box-shadow,transform] duration-150", "focus-visible:outline-none focus-visible:ring-4 focus-visible:ring-[var(--sg-btn-ring)]", "disabled:opacity-60 disabled:cursor-not-allowed", isIconOnly ? cn("aspect-square", s.h) : cn(s.minH, s.py, s.px), s.text, resolvedShape === "rounded" ? "rounded-full" : resolvedShape === "circle" ? "rounded-full" : resolvedShape === "square" ? "rounded-none" : s.radius, appearanceClass(appearance), elevationClass(elevation), !isDisabled ? "active:translate-y-[0.5px]" : false, className), ...rest, onClick: onClick ? handleClick : undefined, children: isLoading ? (_jsxs("span", { className: contentClass, children: [_jsx(Spinner, { className: s.icon }), resolvedChildren ? _jsx("span", { className: "min-w-0 whitespace-normal break-words", children: resolvedChildren }) : null] })) : (_jsxs("span", { className: contentClass, children: [leftIcon ? _jsx("span", { className: cn("shrink-0", s.icon), children: leftIcon }) : null, resolvedChildren ? _jsx("span", { className: "min-w-0 whitespace-normal break-words", children: resolvedChildren }) : null, rightIcon ? _jsx("span", { className: cn("shrink-0", s.icon), children: rightIcon }) : null] })) }));
 });
 SgButton.displayName = "SgButton";
 function Spinner({ className }) {

package/dist/buttons/SgButton.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgButton.meta.d.ts","sourceRoot":"","sources":["../../src/buttons/SgButton.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAiHpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAyBrB,CAAC"}
+{"version":3,"file":"SgButton.meta.d.ts","sourceRoot":"","sources":["../../src/buttons/SgButton.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAoIpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA6BrB,CAAC"}

package/dist/buttons/SgButton.meta.js

@@ -47,7 +47,7 @@ export const sgMeta = {
             name: "loading",
             type: "boolean",
             default: false,
-            description: "Exibe spinner e bloqueia interacao enquanto a acao esta em progresso.",
+            description: "Exibe spinner e bloqueia o clique. Continua valendo e vence o loading automático do onClick: o loading efetivo é loading ou operação pendente (Promise/Future devolvida pelo onClick).",
             semanticRole: "behavior",
             bindable: true
         },
@@ -75,8 +75,8 @@ export const sgMeta = {
         },
         {
             name: "onClick",
-            type: "MouseEventHandler<HTMLButtonElement>",
-            description: "Callback disparado quando a acao e executada.",
+            type: "(event: MouseEvent<HTMLButtonElement>) => unknown",
+            description: "Clique do botão; pode ser síncrono ou assíncrono. Síncrono (abrir modal, alternar): nada muda. Se DEVOLVER uma Promise/Future, como async () => { await salvar(); } ou () => salvar(), o botão entra em loading sozinho (spinner, desabilitado, aria-busy na web), ignora cliques até terminar (inclusive cliques seguidos antes de a tela atualizar) e volta ao normal ao terminar ou falhar. Protege contra duplo clique e reenvio e ajuda na idempotência da ação na tela (não substitui a chave de idempotência no servidor). Cuidado: a função precisa devolver a operação; com chaves e sem return (ou sem async), como () => { salvar(); } ou () { salvar(); }, não protege; já async () {...} sempre devolve. O erro não é engolido: o botão sai do loading e relança como rejeição não tratada; trate com try/catch dentro do onClick e avise o usuário (sgWhistle.error). Use async só quando a ação puder demorar ou falhar (salvar, enviar, pagar).",
             semanticRole: "event",
             bindable: false
         }
@@ -89,6 +89,24 @@ export const sgMeta = {
             file: "apps/showcase/src/app/components/sg-button/samples/basico.tsx.sample",
             kind: "sample"
         },
+        {
+            id: "auto-loading",
+            title: "Loading automático com Future",
+            file: "apps/showcase/src/app/components/sg-button/samples/loading-automatico-com-future.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "sync-vs-async",
+            title: "onClick síncrono x assíncrono",
+            file: "apps/showcase/src/app/components/sg-button/samples/onclick-sincrono-x-assincrono.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "async-error",
+            title: "Tratando erro no onClick assíncrono",
+            file: "apps/showcase/src/app/components/sg-button/samples/tratando-erro-no-onclick-assincrono.tsx.sample",
+            kind: "sample"
+        },
         {
             id: "playground",
             title: "Playground",
@@ -116,7 +134,8 @@ export const aiHints = {
     preferredUseCases: [
         "Acoes primarias e secundarias em formularios e telas CRUD.",
         "Submit, confirmacao, salvar, cancelar e outras acoes explicitas do usuario.",
-        "Chamadas para acao com feedback visual de loading."
+        "Chamadas para acao com feedback visual de loading.",
+        "Salvar, enviar ou pagar: use onClick assíncrono (async () => { await salvar(); } ou () => salvar()) para o botão entrar em loading sozinho e ignorar duplo clique; acoes instantaneas (abrir modal, alternar) ficam sincronas."
     ],
     avoidUseCases: [
         "Agrupar conteudo ou estruturar layout; nesses casos prefira SgPanel, SgCard ou SgStack.",
@@ -127,7 +146,10 @@ export const aiHints = {
     relatedEntityFields: ["submit", "save", "cancel", "confirm", "delete"],
     compositionHints: [
         "Combinar com SgInputText e outros campos em formularios.",
-        "Usar dentro de SgPanel ou SgDialog para acoes contextuais."
+        "Usar dentro de SgPanel ou SgDialog para acoes contextuais.",
+        "O onClick precisa DEVOLVER a Promise/Future para o loading automatico funcionar: onClick={() => { salvar(); }} (chaves sem return) nao protege; use () => salvar() ou async () => { await salvar(); }. No Flutter, async () {...} sempre devolve Future; () { salvar(); } nao.",
+        "O botao nao engole o erro do onClick assincrono: sai do loading e relanca como rejeicao nao tratada. Trate com try/catch dentro do onClick e avise o usuario com sgWhistle.error (Flutter: sgWhistle.error(SgWhistleOptions(...))).",
+        "O loading automatico protege a acao na tela (duplo clique/reenvio), mas nao substitui a chave de idempotencia no servidor. A prop loading manual vence: loading efetivo = loading ou operacao pendente."
     ],
     rankingSignals: {
         freeText: 0,

package/dist/gadgets/calendar/SgCalendar.d.ts

@@ -18,6 +18,12 @@ export type SgCalendarProps = Omit<React.HTMLAttributes<HTMLDivElement>, "childr
     minDate?: Date | string;
     maxDate?: Date | string;
     isDateDisabled?: (date: Date) => boolean;
+    /**
+     * Habilita o calendario (padrao `true`). Com `false` os dias, os botoes de mes anterior/proximo
+     * e o atalho "hoje" ficam desabilitados (nao focaveis, sem clique); a data e o mes atuais seguem
+     * legiveis.
+     */
+    enabled?: boolean;
     showTodayShortcut?: boolean;
     cardTitle?: React.ReactNode;
     cardProps?: Omit<SgCardProps, "children" | "title">;

package/dist/gadgets/calendar/SgCalendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgCalendar.d.ts","sourceRoot":"","sources":["../../../src/gadgets/calendar/SgCalendar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAuG/D,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,GAAG;IAClG,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,2CAgU1D;yBAhUe,UAAU"}
+{"version":3,"file":"SgCalendar.d.ts","sourceRoot":"","sources":["../../../src/gadgets/calendar/SgCalendar.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAuG/D,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC,GAAG;IAClG,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,KAAK,IAAI,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,2CAwU1D;yBAxUe,UAAU"}

package/dist/gadgets/calendar/SgCalendar.js

@@ -92,7 +92,7 @@ function capitalizeFirst(value, locale) {
 }
 export function SgCalendar(props) {
     const i18n = useComponentsI18n();
-    const { value, defaultValue, onValueChange, viewDate, defaultViewDate, onViewDateChange, locale = "pt-BR", weekStartsOn = 0, weekdayFormat = "narrow", numberOfMonths = 1, monthsPerLine = 3, monthMinWidth, showAdjacentMonths = true, minDate, maxDate, isDateDisabled, showTodayShortcut = true, className, style, cardTitle, cardProps, ...rest } = props;
+    const { value, defaultValue, onValueChange, viewDate, defaultViewDate, onViewDateChange, locale = "pt-BR", weekStartsOn = 0, weekdayFormat = "narrow", numberOfMonths = 1, monthsPerLine = 3, monthMinWidth, showAdjacentMonths = true, minDate, maxDate, isDateDisabled, enabled = true, showTodayShortcut = true, className, style, cardTitle, cardProps, ...rest } = props;
     const resolvedCardTitle = cardTitle ?? t(i18n, "components.gadgets.calendar.title");
     const today = React.useMemo(() => normalizeDate(new Date()), []);
     const valueControlled = value !== undefined;
@@ -171,6 +171,8 @@ export function SgCalendar(props) {
         return false;
     }, [isDateDisabled, parsedMaxDate, parsedMinDate]);
     const handleSelectDate = React.useCallback((date) => {
+        if (!enabled)
+            return;
         if (isCellDisabled(date))
             return;
         if (!valueControlled) {
@@ -180,8 +182,10 @@ export function SgCalendar(props) {
         if (!isSameMonth(date, monthViewDate)) {
             setMonthViewDate(date);
         }
-    }, [isCellDisabled, monthViewDate, onValueChange, setMonthViewDate, valueControlled]);
+    }, [enabled, isCellDisabled, monthViewDate, onValueChange, setMonthViewDate, valueControlled]);
     const handleGoToday = React.useCallback(() => {
+        if (!enabled)
+            return;
         const now = normalizeDate(new Date());
         if (!isCellDisabled(now)) {
             if (!valueControlled) {
@@ -190,7 +194,7 @@ export function SgCalendar(props) {
             onValueChange?.(new Date(now));
         }
         setMonthViewDate(now);
-    }, [isCellDisabled, onValueChange, setMonthViewDate, valueControlled]);
+    }, [enabled, isCellDisabled, onValueChange, setMonthViewDate, valueControlled]);
     const monthDates = React.useMemo(() => Array.from({ length: safeNumberOfMonths }, (_, index) => addMonths(monthViewDate, index)), [monthViewDate, safeNumberOfMonths]);
     const selectedLabel = capitalizeFirst(formatSelectedDate.format(selectedDate), locale);
     const visibleColumns = Math.min(safeMonthsPerLine, safeNumberOfMonths);
@@ -206,7 +210,7 @@ export function SgCalendar(props) {
         maxWidth: "100%",
         ...(cardProps?.style ?? {})
     };
-    return (_jsx(SgCard, { title: resolvedCardTitle, collapsible: true, defaultOpen: true, collapseToggleAlign: "right", collapseIconSize: 20, draggable: true, bgColor: "rgb(var(--sg-surface,var(--sg-bg)))", bgColorTitle: "rgb(var(--sg-surface-2,var(--sg-surface,var(--sg-bg))))", cardStyle: "outlined", ...cardProps, className: mergedCardClassName, bodyClassName: mergedCardBodyClassName, style: mergedCardStyle, children: _jsxs("div", { className: cn("inline-flex max-w-full select-none flex-col gap-3", className), style: style, ...rest, children: [_jsxs("div", { className: "flex items-center justify-between gap-3 rounded-lg border border-border/70 bg-background px-4 py-3", children: [_jsx("div", { className: "min-h-6 text-sm font-medium text-foreground", children: selectedLabel }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx("button", { type: "button", onClick: () => setMonthViewDate(addMonths(monthViewDate, -1)), className: "inline-flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", "aria-label": uiLabels.previousMonth, title: uiLabels.previousMonth, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "m12.5 5.8-4.2 4.2 4.2 4.2", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) }), _jsx("button", { type: "button", onClick: () => setMonthViewDate(addMonths(monthViewDate, 1)), className: "inline-flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", "aria-label": uiLabels.nextMonth, title: uiLabels.nextMonth, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "m7.5 5.8 4.2 4.2-4.2 4.2", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) }), showTodayShortcut ? (_jsx("button", { type: "button", onClick: handleGoToday, className: "inline-flex h-8 w-8 items-center justify-center rounded-md border border-border/70 bg-muted/40 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", "aria-label": uiLabels.goToday, title: uiLabels.goToday, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "M5.6 7.6 10 12l4.4-4.4", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) })) : null] })] }), _jsx("div", { className: "max-h-full max-w-full overflow-auto", children: _jsx("div", { className: "grid gap-4", style: monthGridStyle, children: monthDates.map((monthDate) => {
+    return (_jsx(SgCard, { title: resolvedCardTitle, collapsible: true, defaultOpen: true, collapseToggleAlign: "right", collapseIconSize: 20, draggable: true, bgColor: "rgb(var(--sg-surface,var(--sg-bg)))", bgColorTitle: "rgb(var(--sg-surface-2,var(--sg-surface,var(--sg-bg))))", cardStyle: "outlined", ...cardProps, className: mergedCardClassName, bodyClassName: mergedCardBodyClassName, style: mergedCardStyle, children: _jsxs("div", { className: cn("inline-flex max-w-full select-none flex-col gap-3", !enabled && "opacity-60", className), style: style, "aria-disabled": enabled ? undefined : true, ...rest, children: [_jsxs("div", { className: "flex items-center justify-between gap-3 rounded-lg border border-border/70 bg-background px-4 py-3", children: [_jsx("div", { className: "min-h-6 text-sm font-medium text-foreground", children: selectedLabel }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsx("button", { type: "button", onClick: () => enabled && setMonthViewDate(addMonths(monthViewDate, -1)), disabled: !enabled, className: "inline-flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground disabled:cursor-not-allowed disabled:hover:bg-transparent", "aria-label": uiLabels.previousMonth, title: uiLabels.previousMonth, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "m12.5 5.8-4.2 4.2 4.2 4.2", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) }), _jsx("button", { type: "button", onClick: () => enabled && setMonthViewDate(addMonths(monthViewDate, 1)), disabled: !enabled, className: "inline-flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", "aria-label": uiLabels.nextMonth, title: uiLabels.nextMonth, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "m7.5 5.8 4.2 4.2-4.2 4.2", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) }), showTodayShortcut ? (_jsx("button", { type: "button", onClick: handleGoToday, disabled: !enabled, className: "inline-flex h-8 w-8 items-center justify-center rounded-md border border-border/70 bg-muted/40 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground", "aria-label": uiLabels.goToday, title: uiLabels.goToday, children: _jsx("svg", { viewBox: "0 0 20 20", className: "h-4 w-4", "aria-hidden": "true", children: _jsx("path", { d: "M5.6 7.6 10 12l4.4-4.4", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round" }) }) })) : null] })] }), _jsx("div", { className: "max-h-full max-w-full overflow-auto", children: _jsx("div", { className: "grid gap-4", style: monthGridStyle, children: monthDates.map((monthDate) => {
                             const firstDayOfMonth = startOfMonth(monthDate);
                             const firstDayOffset = (firstDayOfMonth.getDay() - safeWeekStartsOn + 7) % 7;
                             const gridStart = addDays(firstDayOfMonth, -firstDayOffset);
@@ -215,7 +219,7 @@ export function SgCalendar(props) {
                             return (_jsxs("div", { className: "rounded-xl border border-border/70 bg-background", children: [_jsx("div", { className: "border-b border-border/70 px-4 py-3", children: _jsx("div", { className: "text-[1.1rem] font-semibold text-foreground", children: monthLabel }) }), _jsxs("div", { className: "px-4 pb-4 pt-3", children: [_jsx("div", { className: "mb-2 grid grid-cols-7 text-center text-[0.79rem] font-medium uppercase tracking-wide text-muted-foreground", children: weekdayLabels.map((label, index) => (_jsx("span", { className: "py-1", children: label }, `${label}-${index}`))) }), _jsx("div", { className: "grid grid-cols-7 gap-y-1", children: days.map((day) => {
                                                     const inCurrentMonth = isSameMonth(day, monthDate);
                                                     const hiddenAdjacentDay = !showAdjacentMonths && !inCurrentMonth;
-                                                    const disabled = isCellDisabled(day);
+                                                    const disabled = !enabled || isCellDisabled(day);
                                                     const selected = isSameDay(day, selectedDate) && inCurrentMonth;
                                                     const isToday = isSameDay(day, today) && inCurrentMonth;
                                                     if (hiddenAdjacentDay) {

package/dist/gadgets/calendar/SgCalendar.meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgCalendar.meta.d.ts","sourceRoot":"","sources":["../../../src/gadgets/calendar/SgCalendar.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,MAAM,EAAE,QA+BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}
+{"version":3,"file":"SgCalendar.meta.d.ts","sourceRoot":"","sources":["../../../src/gadgets/calendar/SgCalendar.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,MAAM,EAAE,QAgCpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/gadgets/calendar/SgCalendar.meta.js

@@ -19,6 +19,7 @@ export const sgMeta = {
         { name: "numberOfMonths", type: "number", default: 1, description: "Quantidade de meses visiveis ao mesmo tempo.", semanticRole: "appearance", bindable: true },
         { name: "minDate", type: "Date | string", description: "Limite minimo de selecao.", semanticRole: "validation", bindable: true },
         { name: "maxDate", type: "Date | string", description: "Limite maximo de selecao.", semanticRole: "validation", bindable: true },
+        { name: "enabled", type: "boolean", default: true, description: "Quando false, os dias, os botoes de mes anterior/proximo e o atalho hoje ficam desabilitados (nao focaveis); a data e o mes atuais continuam legiveis.", semanticRole: "behavior", bindable: true },
         { name: "onValueChange", type: "(date: Date) => void", description: "Callback disparado ao selecionar uma data.", semanticRole: "event", bindable: false }
     ],
     states: ["default", "multi-month", "disabled-dates", "controlled"],