@seedgrid/fe-components 2026.9.5 → 2026.10.1

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

@@ -3075,14 +3075,6 @@
             "semanticRole": "behavior",
             "bindable": true
           },
-          {
-            "name": "rowsPerPage",
-            "type": "number",
-            "required": false,
-            "description": "Quantidade de linhas por pagina.",
-            "semanticRole": "behavior",
-            "bindable": true
-          },
           {
             "name": "onPage",
             "type": "(event: SgDatatablePageEvent) => void",
@@ -4027,22 +4019,6 @@
             "semanticRole": "validation",
             "bindable": true
           },
-          {
-            "name": "min",
-            "type": "number",
-            "required": false,
-            "description": "Valor minimo aceito.",
-            "semanticRole": "validation",
-            "bindable": true
-          },
-          {
-            "name": "max",
-            "type": "number",
-            "required": false,
-            "description": "Valor maximo aceito.",
-            "semanticRole": "validation",
-            "bindable": true
-          },
           {
             "name": "decimals",
             "type": "number",
@@ -4367,14 +4343,6 @@
             "semanticRole": "behavior",
             "bindable": true
           },
-          {
-            "name": "symbol",
-            "type": "string",
-            "required": false,
-            "description": "Simbolo monetario exibido no campo.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "required",
             "type": "boolean",
@@ -4384,22 +4352,6 @@
             "semanticRole": "validation",
             "bindable": true
           },
-          {
-            "name": "min",
-            "type": "number",
-            "required": false,
-            "description": "Valor monetario minimo aceito.",
-            "semanticRole": "validation",
-            "bindable": true
-          },
-          {
-            "name": "max",
-            "type": "number",
-            "required": false,
-            "description": "Valor monetario maximo aceito.",
-            "semanticRole": "validation",
-            "bindable": true
-          },
           {
             "name": "onChange",
             "type": "(value: number | null) => void",
@@ -7464,22 +7416,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "sourceLabel",
-            "type": "string",
-            "required": false,
-            "description": "Rotulo da lista de origem.",
-            "semanticRole": "label",
-            "bindable": true
-          },
-          {
-            "name": "targetLabel",
-            "type": "string",
-            "required": false,
-            "description": "Rotulo da lista de destino.",
-            "semanticRole": "label",
-            "bindable": true
-          },
           {
             "name": "selectionMode",
             "type": "string",
@@ -7488,15 +7424,6 @@
             "semanticRole": "behavior",
             "bindable": true
           },
-          {
-            "name": "showFilters",
-            "type": "boolean",
-            "required": false,
-            "default": true,
-            "description": "Exibe filtros nas listas.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "disabled",
             "type": "boolean",
@@ -7953,14 +7880,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "max",
-            "type": "number",
-            "required": false,
-            "description": "Quantidade maxima de itens de avaliacao.",
-            "semanticRole": "validation",
-            "bindable": true
-          },
           {
             "name": "readOnly",
             "type": "boolean",
@@ -8547,31 +8466,6 @@
             "semanticRole": "data",
             "bindable": false
           },
-          {
-            "name": "label",
-            "type": "string",
-            "required": false,
-            "description": "Rotulo exibido ao usuario.",
-            "semanticRole": "label",
-            "bindable": true
-          },
-          {
-            "name": "value",
-            "type": "string",
-            "required": false,
-            "description": "Conteudo atual do editor.",
-            "semanticRole": "value",
-            "bindable": true
-          },
-          {
-            "name": "readOnly",
-            "type": "boolean",
-            "required": false,
-            "default": false,
-            "description": "Impede edicao do conteudo.",
-            "semanticRole": "behavior",
-            "bindable": true
-          },
           {
             "name": "placeholder",
             "type": "string",
@@ -8588,14 +8482,6 @@
             "semanticRole": "appearance",
             "bindable": true
           },
-          {
-            "name": "onChange",
-            "type": "(value: string) => void",
-            "required": false,
-            "description": "Callback de mudanca do conteudo.",
-            "semanticRole": "event",
-            "bindable": false
-          },
           {
             "name": "onSave",
             "type": "(meta: SgTextEditorSaveMeta) => void",
@@ -8782,14 +8668,6 @@
             "semanticRole": "label",
             "bindable": true
           },
-          {
-            "name": "placeholder",
-            "type": "string",
-            "required": false,
-            "description": "Texto de apoio para orientar o conteudo esperado.",
-            "semanticRole": "label",
-            "bindable": true
-          },
           {
             "name": "required",
             "type": "boolean",
@@ -8799,14 +8677,6 @@
             "semanticRole": "validation",
             "bindable": true
           },
-          {
-            "name": "rows",
-            "type": "number",
-            "required": false,
-            "description": "Quantidade inicial de linhas visiveis.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "maxLength",
             "type": "number",
@@ -9108,15 +8978,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "disabled",
-            "type": "boolean",
-            "required": false,
-            "default": false,
-            "description": "Desabilita interacao.",
-            "semanticRole": "behavior",
-            "bindable": true
-          },
           {
             "name": "readOnly",
             "type": "boolean",
@@ -9126,22 +8987,6 @@
             "semanticRole": "behavior",
             "bindable": true
           },
-          {
-            "name": "checkedLabel",
-            "type": "string",
-            "required": false,
-            "description": "Texto exibido no estado ligado.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
-          {
-            "name": "uncheckedLabel",
-            "type": "string",
-            "required": false,
-            "description": "Texto exibido no estado desligado.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "onChange",
             "type": "(checked: boolean) => void",
@@ -16658,23 +16503,6 @@
             "semanticRole": "data",
             "bindable": true
           },
-          {
-            "name": "selectionMode",
-            "type": "\"single\" | \"multiple\" | \"checkbox\"",
-            "required": false,
-            "default": "single",
-            "description": "Modo principal de selecao dos nos.",
-            "semanticRole": "behavior",
-            "bindable": true
-          },
-          {
-            "name": "selectedIds",
-            "type": "string[]",
-            "required": false,
-            "description": "Nos selecionados de forma controlada.",
-            "semanticRole": "value",
-            "bindable": true
-          },
           {
             "name": "checkedIds",
             "type": "string[]",
@@ -16692,15 +16520,6 @@
             "semanticRole": "behavior",
             "bindable": true
           },
-          {
-            "name": "expandAllByDefault",
-            "type": "boolean",
-            "required": false,
-            "default": false,
-            "description": "Expande a arvore inteira na montagem inicial.",
-            "semanticRole": "behavior",
-            "bindable": true
-          },
           {
             "name": "size",
             "type": "\"sm\" | \"md\" | \"lg\"",
@@ -16710,14 +16529,6 @@
             "semanticRole": "appearance",
             "bindable": true
           },
-          {
-            "name": "onSelectionChange",
-            "type": "(ids: string[]) => void",
-            "required": false,
-            "description": "Callback disparado quando a selecao muda.",
-            "semanticRole": "event",
-            "bindable": false
-          },
           {
             "name": "branchLabelBehavior",
             "type": "\"none\" | \"toggle\"",
@@ -18397,6 +18208,367 @@
         }
       }
     },
+    {
+      "componentId": "provider.realtime",
+      "exportName": "SgRealtimeProvider",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "provider.realtime",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgRealtimeProvider",
+        "slug": "sg-realtime-provider",
+        "displayName": "SgRealtimeProvider",
+        "category": "provider",
+        "subcategory": "realtime",
+        "description": "Avisos em tempo real para o usuario logado pelo SeedGrid Pulse: pede o token de conexao ao backend (que o emite para o usuario da sessao), conecta direto no Pulse, reconecta sozinho, para quando a credencial e revogada e expoe o status para a tela decidir entre aviso e polling de reserva.",
+        "tags": [
+          "provider",
+          "realtime",
+          "pulse",
+          "websocket",
+          "notification",
+          "polling"
+        ],
+        "capabilities": [
+          "token-from-backend",
+          "auto-reconnect",
+          "channel-subscription",
+          "fallback-status"
+        ],
+        "fieldSemantics": [
+          "realtimeChannels",
+          "tokenEndpoint",
+          "connectionStatus"
+        ],
+        "props": [
+          {
+            "name": "channels",
+            "type": "string[]",
+            "required": true,
+            "description": "Channels que a aplicacao quer ouvir (ex.: [\"backup\"]).",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "tokenEndpoint",
+            "type": "string",
+            "required": false,
+            "default": "/api/realtime/connect",
+            "description": "Rota que entrega o token de conexao do usuario logado (a BFF, na mesma origem).",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Liga/desliga (ex.: false enquanto nao ha usuario logado).",
+            "semanticRole": "behavior",
+            "bindable": true
+          },
+          {
+            "name": "children",
+            "type": "ReactNode",
+            "required": true,
+            "description": "Arvore que ouve os avisos com useSgRealtimeEvent.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "connectOptions",
+            "type": "Omit<ConnectInput, \"getToken\" | \"accountKey\" | \"baseUrl\">",
+            "required": false,
+            "description": "Opções avançadas do cliente do Pulse (reconexão, `webSocketImpl` em testes...)."
+          },
+          {
+            "name": "fetchToken",
+            "type": "(() => Promise<SgRealtimeConnectResponse>)",
+            "required": false,
+            "description": "Substitui o pedido de token inteiro (apps sem BFF, testes)."
+          },
+          {
+            "name": "pulseUrl",
+            "type": "string",
+            "required": false,
+            "description": "Endereço do Pulse, usado quando o token não traz `connectUrl` (Pulse sem endereço público)."
+          },
+          {
+            "name": "tokenRequestInit",
+            "type": "RequestInit",
+            "required": false,
+            "description": "Opções do `fetch` do token (ex.: `headers: { Authorization: ... }` quando não há cookie)."
+          }
+        ],
+        "states": [
+          "idle",
+          "disabled",
+          "connecting",
+          "connected",
+          "reconnecting",
+          "unavailable",
+          "auth-error"
+        ],
+        "examples": [
+          {
+            "id": "simulador",
+            "title": "Simulador",
+            "file": "apps/showcase/src/app/components/providers/sg-realtime-provider/samples/simulador.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "layout-com-bff",
+            "title": "No layout, com a BFF",
+            "file": "apps/showcase/src/app/components/providers/sg-realtime-provider/samples/layout-com-bff.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "polling-de-reserva",
+            "title": "Polling de reserva",
+            "file": "apps/showcase/src/app/components/providers/sg-realtime-provider/samples/polling-de-reserva.tsx.sample",
+            "kind": "sample"
+          }
+        ],
+        "showcase": {
+          "route": "/components/providers/sg-realtime-provider",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "provider.realtime",
+          "acceptsDataBinding": true,
+          "defaultProps": {
+            "channels": [],
+            "tokenEndpoint": "/api/realtime/connect",
+            "enabled": true
+          }
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Avisar o usuario quando um processo demorado termina (backup, relatorio, importacao) sem polling.",
+          "Atualizar uma lista quando o backend publica um evento para o usuario logado."
+        ],
+        "avoidUseCases": [
+          "Transportar dados de negocio: o aviso so leva identificadores; busque o registro pela API.",
+          "Mensagens entre usuarios ou chat."
+        ],
+        "synonyms": [
+          "realtime provider",
+          "pulse provider",
+          "websocket provider",
+          "push notifications"
+        ],
+        "relatedEntityFields": [
+          "channel",
+          "event",
+          "userPublicId"
+        ],
+        "compositionHints": [
+          "Montar uma vez no layout autenticado e ouvir com useSgRealtimeEvent nas telas.",
+          "Usar useSgRealtimeStatus para ligar o polling de reserva quando nao estiver conectado."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0
+        }
+      }
+    },
+    {
+      "componentId": "hook.realtime-event",
+      "exportName": "useSgRealtimeEvent",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "hook.realtime-event",
+        "package": "@seedgrid/fe-components",
+        "exportName": "useSgRealtimeEvent",
+        "slug": "use-sg-realtime-event",
+        "displayName": "useSgRealtimeEvent",
+        "category": "hook",
+        "subcategory": "realtime",
+        "description": "Hook que chama o handler a cada aviso do SgRealtimeProvider no channel informado cujo evento casa o padrao (nome, lista, prefixo.* ou *).",
+        "tags": [
+          "hook",
+          "realtime",
+          "pulse",
+          "event"
+        ],
+        "capabilities": [
+          "event-subscription",
+          "wildcard-match"
+        ],
+        "fieldSemantics": [
+          "realtimeChannel",
+          "eventPattern",
+          "eventHandler"
+        ],
+        "props": [
+          {
+            "name": "channel",
+            "type": "string",
+            "required": true,
+            "description": "Channel do aviso (ex.: \"backup\").",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "events",
+            "type": "string | string[]",
+            "required": true,
+            "description": "Nome do evento, lista, \"prefixo.*\" ou \"*\".",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "handler",
+            "type": "(event: SgRealtimeEvent) => void",
+            "required": true,
+            "description": "Chamado a cada aviso que casa.",
+            "semanticRole": "behavior",
+            "bindable": false
+          }
+        ],
+        "states": [
+          "listening"
+        ],
+        "examples": [
+          {
+            "id": "uso-basico",
+            "title": "Uso basico",
+            "file": "apps/showcase/src/app/components/hooks/use-sg-realtime-event/samples/uso-basico.tsx.sample",
+            "kind": "sample"
+          }
+        ],
+        "showcase": {
+          "route": "/components/hooks/use-sg-realtime-event",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Recarregar uma tela quando o backend avisa que um processo terminou."
+        ],
+        "avoidUseCases": [
+          "Ler dados de negocio do aviso: ele so traz identificadores."
+        ],
+        "synonyms": [
+          "realtime event",
+          "pulse event",
+          "on notice"
+        ],
+        "relatedEntityFields": [
+          "channel",
+          "event"
+        ],
+        "compositionHints": [
+          "Usar dentro de um SgRealtimeProvider que assina o channel."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0
+        }
+      }
+    },
+    {
+      "componentId": "hook.realtime-status",
+      "exportName": "useSgRealtimeStatus",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "hook.realtime-status",
+        "package": "@seedgrid/fe-components",
+        "exportName": "useSgRealtimeStatus",
+        "slug": "use-sg-realtime-status",
+        "displayName": "useSgRealtimeStatus",
+        "category": "hook",
+        "subcategory": "realtime",
+        "description": "Hook com o estado da conexao do SgRealtimeProvider com o Pulse. connected falso indica que a tela deve usar o polling de reserva.",
+        "tags": [
+          "hook",
+          "realtime",
+          "pulse",
+          "status",
+          "polling"
+        ],
+        "capabilities": [
+          "connection-status",
+          "fallback-signal"
+        ],
+        "fieldSemantics": [
+          "connectionStatus",
+          "connected"
+        ],
+        "props": [
+          {
+            "name": "returns.status",
+            "type": "SgRealtimeStatus",
+            "description": "idle, disabled, connecting, connected, reconnecting, unavailable ou auth-error.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "returns.connected",
+            "type": "boolean",
+            "description": "true so com a conexao aberta e assinada.",
+            "semanticRole": "data",
+            "bindable": false
+          }
+        ],
+        "states": [
+          "disabled",
+          "connected",
+          "unavailable"
+        ],
+        "examples": [
+          {
+            "id": "uso-basico",
+            "title": "Uso basico",
+            "file": "apps/showcase/src/app/components/hooks/use-sg-realtime-status/samples/uso-basico.tsx.sample",
+            "kind": "sample"
+          }
+        ],
+        "showcase": {
+          "route": "/components/hooks/use-sg-realtime-status",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Decidir entre aviso em tempo real e polling de reserva numa tela."
+        ],
+        "avoidUseCases": [
+          "Decidir permissao ou autenticacao: o status so diz da conexao com o Pulse."
+        ],
+        "synonyms": [
+          "realtime status",
+          "pulse status",
+          "connection state"
+        ],
+        "relatedEntityFields": [
+          "status"
+        ],
+        "compositionHints": [
+          "Usar dentro de um SgRealtimeProvider; fora dele o status e disabled."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0
+        }
+      }
+    },
     {
       "componentId": "gadget.clock-theme-picker",
       "exportName": "SgClockThemePicker",
@@ -20495,15 +20667,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "fontSize",
-            "type": "number",
-            "required": false,
-            "default": 72,
-            "description": "Escala visual do display.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "color",
             "type": "string",
@@ -20892,22 +21055,6 @@
             "semanticRole": "appearance",
             "bindable": true
           },
-          {
-            "name": "color",
-            "type": "string",
-            "required": false,
-            "description": "Cor principal do digito.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
-          {
-            "name": "backgroundColor",
-            "type": "string",
-            "required": false,
-            "description": "Cor do fundo do display.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "className",
             "type": "string",
@@ -21038,15 +21185,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "fontSize",
-            "type": "number",
-            "required": false,
-            "default": 72,
-            "description": "Escala visual do digito.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "color",
             "type": "string",
@@ -21055,14 +21193,6 @@
             "semanticRole": "appearance",
             "bindable": true
           },
-          {
-            "name": "backgroundColor",
-            "type": "string",
-            "required": false,
-            "description": "Cor de fundo do display.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "className",
             "type": "string",
@@ -21186,15 +21316,6 @@
             "semanticRole": "value",
             "bindable": true
           },
-          {
-            "name": "fontSize",
-            "type": "number",
-            "required": false,
-            "default": 72,
-            "description": "Escala visual do digito.",
-            "semanticRole": "appearance",
-            "bindable": true
-          },
           {
             "name": "color",
             "type": "string",