@seedgrid/fe-components 2026.11.2 → 2026.11.3

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

@@ -914,7 +914,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -1796,7 +1796,7 @@
           },
           {
             "name": "options",
-            "type": "{ label: string; value: string | number; chipLabel?: string; disabled?: boolean }[]",
+            "type": "{ label: string; value: string | number; chipLabel?: string; enabled?: boolean }[]",
             "required": true,
             "description": "Lista de opcoes disponiveis. `label` aparece na lista; `chipLabel` (opcional) e' o texto curto do item ja' selecionado (o resumo do campo), ex.: label \"3 - Filial Centro\" e chipLabel \"3\".",
             "semanticRole": "data",
@@ -2132,7 +2132,7 @@
           },
           {
             "name": "options",
-            "type": "{ label: string; value: string | number; chipLabel?: string; disabled?: boolean }[]",
+            "type": "{ label: string; value: string | number; chipLabel?: string; enabled?: boolean }[]",
             "required": true,
             "description": "Lista de opcoes disponiveis. `label` aparece na lista; `chipLabel` (opcional) e' o texto curto do item ja' selecionado (o chip), ex.: label \"3 - Filial Centro\" e chipLabel \"3\".",
             "semanticRole": "data",
@@ -3085,10 +3085,37 @@
             "name": "columns",
             "type": "SgDatatableColumn[]",
             "required": true,
-            "description": "Definicao das colunas da tabela.",
+            "description": "Definicao das colunas da tabela. column.filterPlaceholder vence o dicionario (components.datatable.columnFilterPlaceholder).",
             "semanticRole": "data",
             "bindable": true
           },
+          {
+            "name": "emptyMessage",
+            "type": "string",
+            "required": false,
+            "default": "(dicionario)",
+            "description": "Mensagem exibida quando nao ha registros. Vence o dicionario (components.datatable.empty).",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "globalFilterPlaceholder",
+            "type": "string",
+            "required": false,
+            "default": "(dicionario)",
+            "description": "Placeholder da busca global. Vence o dicionario (components.datatable.globalFilterPlaceholder).",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "columnManagerLabel",
+            "type": "string",
+            "required": false,
+            "default": "(dicionario)",
+            "description": "Titulo do painel de colunas. Vence o dicionario (components.datatable.columns).",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
           {
             "name": "rows",
             "type": "number",
@@ -3165,11 +3192,6 @@
             "semanticRole": "event",
             "bindable": false
           },
-          {
-            "name": "columnManagerLabel",
-            "type": "string",
-            "required": false
-          },
           {
             "name": "columnManagerMaxHeight",
             "type": "string | number",
@@ -3180,11 +3202,6 @@
             "type": "string",
             "required": false
           },
-          {
-            "name": "emptyMessage",
-            "type": "string",
-            "required": false
-          },
           {
             "name": "filters",
             "type": "Record<string, string>",
@@ -3200,11 +3217,6 @@
             "type": "string",
             "required": false
           },
-          {
-            "name": "globalFilterPlaceholder",
-            "type": "string",
-            "required": false
-          },
           {
             "name": "groupBoxProps",
             "type": "(Omit<Partial<SgGroupBoxProps>, \"title\" | \"children\"> & { title?: string; })",
@@ -5528,10 +5540,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita a escolha e a remocao.",
             "semanticRole": "appearance",
             "bindable": true
@@ -5854,10 +5866,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita a escolha e a remocao.",
             "semanticRole": "appearance",
             "bindable": true
@@ -6109,10 +6121,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Nao abre a camera nem permite capturar.",
             "semanticRole": "appearance",
             "bindable": true
@@ -8042,10 +8054,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -8090,7 +8102,7 @@
           },
           {
             "name": "itemTemplate",
-            "type": "((item: SgOrderListItem, state: { index: number; selected: boolean; disabled: boolean; }) => ReactNode)",
+            "type": "((item: SgOrderListItem, state: { index: number; selected: boolean; enabled: boolean; }) => ReactNode)",
             "required": false
           },
           {
@@ -8314,7 +8326,7 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -8521,10 +8533,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita os tres combos (ano, recorte e fatia).",
             "semanticRole": "behavior",
             "bindable": true
@@ -8570,7 +8582,7 @@
               "BIMESTER"
             ],
             "locale": "pt-BR",
-            "disabled": false,
+            "enabled": true,
             "required": false
           }
         }
@@ -8687,10 +8699,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -8735,7 +8747,7 @@
           },
           {
             "name": "itemTemplate",
-            "type": "((item: SgPickListItem, state: { index: number; selected: boolean; disabled: boolean; list: SgPickListListName; }) => ReactNode)",
+            "type": "((item: SgPickListItem, state: { index: number; selected: boolean; enabled: boolean; list: SgPickListListName; }) => ReactNode)",
             "required": false
           },
           {
@@ -8992,7 +9004,7 @@
             "bindable": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -9152,10 +9164,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -9392,10 +9404,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -9580,10 +9592,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -9768,7 +9780,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -10355,7 +10367,7 @@
           "acceptsDataBinding": true,
           "defaultProps": {
             "checked": false,
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -10477,11 +10489,11 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
-            "description": "Desabilita a interacao do botao.",
+            "default": true,
+            "description": "Quando false, desabilita a interacao do botao.",
             "semanticRole": "behavior",
             "bindable": true
           },
@@ -10680,10 +10692,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita a acao principal e as acoes derivadas.",
             "semanticRole": "behavior",
             "bindable": true
@@ -10954,10 +10966,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita a acao principal e o menu secundario.",
             "semanticRole": "behavior",
             "bindable": true
@@ -11034,7 +11046,7 @@
           "defaultProps": {
             "severity": "primary",
             "appearance": "solid",
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -11184,7 +11196,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -11561,7 +11573,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -14783,11 +14795,6 @@
             "type": "SgCardPosition",
             "required": false
           },
-          {
-            "name": "disabled",
-            "type": "boolean",
-            "required": false
-          },
           {
             "name": "draggable",
             "type": "boolean",
@@ -14798,6 +14805,11 @@
             "type": "string",
             "required": false
           },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false
+          },
           {
             "name": "footer",
             "type": "ReactNode",
@@ -16893,10 +16905,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita a selecao da pagina.",
             "semanticRole": "behavior",
             "bindable": true
@@ -16944,7 +16956,7 @@
           "acceptsDataBinding": true,
           "defaultProps": {
             "hidden": false,
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -17639,10 +17651,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -17680,7 +17692,7 @@
           "defaultProps": {
             "showLabel": false,
             "severity": "plain",
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -19640,6 +19652,252 @@
         }
       }
     },
+    {
+      "componentId": "feedback.notification-bell",
+      "exportName": "SgNotificationBell",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "feedback.notification-bell",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgNotificationBell",
+        "slug": "sg-notification-bell",
+        "displayName": "SgNotificationBell",
+        "category": "feedback",
+        "subcategory": "notification",
+        "description": "Sino de notificacoes do usuario logado: contador de nao lidas, lista de ate 100 notificacoes com titulo, texto, data e estado lida/nao lida, marcar como lida, excluir, marcar todas e limpar. Autonomo: conecta-se sozinho ao Pulse (token vindo do backend, sem apikey no front) e reaproveita o SgRealtimeProvider se houver; com o Pulse desligado faz polling de reserva. Sem regra de negocio: cada tipo de notificacao tem icone e acao ao abrir.",
+        "tags": [
+          "notification",
+          "bell",
+          "inbox",
+          "alert",
+          "realtime",
+          "pulse",
+          "badge",
+          "feedback"
+        ],
+        "capabilities": [
+          "realtime",
+          "polling-fallback",
+          "unread-count",
+          "mark-as-read",
+          "delete",
+          "reduced-motion",
+          "aria-live"
+        ],
+        "fieldSemantics": [
+          "notification",
+          "inbox",
+          "userNotice"
+        ],
+        "props": [
+          {
+            "name": "apiUrl",
+            "type": "string",
+            "required": false,
+            "default": "/api/user-notifications",
+            "description": "Base das rotas da extension user-notifications (BFF, mesma origem).",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "tokenEndpoint",
+            "type": "string",
+            "required": false,
+            "default": "/api/realtime/connect",
+            "description": "Rota que entrega o token do Pulse; usada quando nao ha SgRealtimeProvider acima.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "requestInit",
+            "type": "RequestInit",
+            "required": false,
+            "description": "Opcoes do fetch (ex.: headers com Authorization quando nao ha cookie).",
+            "semanticRole": "behavior",
+            "bindable": false
+          },
+          {
+            "name": "fetcher",
+            "type": "(input: string, init?: RequestInit) => Promise<Response>",
+            "required": false,
+            "description": "Substitui o fetch (apps sem BFF, testes, demonstracao).",
+            "semanticRole": "behavior",
+            "bindable": false
+          },
+          {
+            "name": "types",
+            "type": "Record<string, SgNotificationTypeConfig>",
+            "required": false,
+            "description": "Tipo da notificacao -> icone e acao ao abrir (onOpen). O sino nao conhece o negocio.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "eventPattern",
+            "type": "string",
+            "required": false,
+            "default": "user-notification.*",
+            "description": "Evento do Pulse que dispara a leitura.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "pollIntervalMs",
+            "type": "number",
+            "required": false,
+            "default": 45000,
+            "description": "Intervalo do polling de reserva (so com o Pulse desligado ou fora do ar), preso entre 30 e 60 s, com jitter e backoff em erro.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "maxVisible",
+            "type": "number",
+            "required": false,
+            "default": 100,
+            "description": "Maximo de notificacoes na lista; as mais antigas saem.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "placement",
+            "type": "\"auto\" | \"top\" | \"right\" | \"bottom\" | \"left\"",
+            "required": false,
+            "default": "auto",
+            "description": "De que lado do sino o painel abre (como o placement do SgPopup); auto escolhe o lado em que cabe.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "showUnreadToggle",
+            "type": "boolean",
+            "required": false,
+            "default": "true",
+            "description": "Mostra o interruptor Não lidas no topo do painel; false esconde só o interruptor (o sino fica) e o painel lista tudo.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "defaultUnreadOnly",
+            "type": "boolean",
+            "required": false,
+            "default": "true",
+            "description": "O painel abre em Não lidas (ainda não clicadas); ignorada com showUnreadToggle=false e não persiste entre recargas.",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "onNotification",
+            "type": "(notification: SgNotification) => void",
+            "required": false,
+            "description": "Chegou uma notificacao nova (aviso do Pulse).",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onNotificationDelete",
+            "type": "(notification: SgNotification) => void",
+            "required": false,
+            "description": "O usuario excluiu uma notificacao.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onOpen",
+            "type": "(notification: SgNotification) => void",
+            "required": false,
+            "description": "O usuario abriu uma notificacao (depois do onOpen do tipo).",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onPollingTick",
+            "type": "(stats: SgPollingStats) => void",
+            "required": false,
+            "description": "O polling consultou a API: contador, instante da ultima consulta e motivo (disabled ou unavailable).",
+            "semanticRole": "event",
+            "bindable": false
+          }
+        ],
+        "states": [
+          "loading",
+          "empty",
+          "list",
+          "error"
+        ],
+        "examples": [
+          {
+            "id": "basic",
+            "title": "Basico",
+            "file": "apps/showcase/src/app/components/sg-notification-bell/samples/basico.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "types",
+            "title": "Tipos com icone e acao",
+            "file": "apps/showcase/src/app/components/sg-notification-bell/samples/tipos.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/sg-notification-bell/sg-notification-bell.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-notification-bell",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "feedback.notification-bell",
+          "acceptsDataBinding": true,
+          "defaultProps": {}
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Avisar o usuario logado de algo que terminou ou aconteceu (relatorio pronto, backup, importacao, convite) com historico e contador de nao lidas.",
+          "Barra superior de um app com caixa de notificacoes que atualiza sozinha.",
+          "Qualquer aviso persistente ao usuario que nao deve sumir sozinho."
+        ],
+        "avoidUseCases": [
+          "Mensagem rapida que some sozinha (toast): use o feedback de toast.",
+          "Chat ou mensagens entre usuarios.",
+          "Mostrar notificacoes sem a extension user-notifications no backend."
+        ],
+        "synonyms": [
+          "sino",
+          "notificacoes",
+          "notification bell",
+          "inbox",
+          "avisos do usuario",
+          "caixa de notificacoes",
+          "alerts"
+        ],
+        "relatedEntityFields": [
+          "notification",
+          "alert",
+          "unread",
+          "report",
+          "backup"
+        ],
+        "compositionHints": [
+          "Pôr no cabecalho do layout autenticado; sem SgRealtimeProvider acima ele abre a propria conexao.",
+          "Use types para mapear cada tipo de notificacao a um icone e a acao de abrir (ex.: baixar o relatorio).",
+          "O payload da notificacao so tem identificadores: a acao de abrir busca o arquivo ou registro pela API do dono."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0,
+          "date": 0,
+          "number": 0.2,
+          "denseLayout": 0.2
+        }
+      }
+    },
     {
       "componentId": "hook.realtime-event",
       "exportName": "useSgRealtimeEvent",

package/dist/buttons/SgButton.d.ts

@@ -14,7 +14,9 @@ export type SgButtonCustomColors = {
     activeBg?: string;
     ring?: string;
 };
-export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color"> & {
+export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color" | "disabled"> & {
+    /** Quando false, desabilita o botão. Padrão: true. */
+    enabled?: boolean;
     severity?: Severity;
     appearance?: Appearance;
     size?: Size;
@@ -28,7 +30,9 @@ export type SgButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>,
     customColors?: SgButtonCustomColors;
 };
 export declare function resolveButtonColors(severity: Severity, custom?: SgButtonCustomColors): Required<SgButtonCustomColors>;
-export declare const SgButton: React.ForwardRefExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "color"> & {
+export declare const SgButton: React.ForwardRefExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "disabled" | "color"> & {
+    /** Quando false, desabilita o botão. Padrão: true. */
+    enabled?: boolean;
     severity?: Severity;
     appearance?: Appearance;
     size?: Size;