@seedgrid/fe-components 2026.11.1 → 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; })",
@@ -4975,66 +4987,1246 @@
           {
             "id": "basic",
             "title": "Basico",
-            "file": "apps/showcase/src/app/components/sg-input-date/samples/basico.tsx.sample",
+            "file": "apps/showcase/src/app/components/sg-input-date/samples/basico.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/sg-input-date/sg-input-date.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-input-date",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "field.date",
+          "acceptsDataBinding": true,
+          "defaultProps": {
+            "labelPosition": "float",
+            "clearButton": true
+          }
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Captura de datas de vencimento, agendamento, cadastro e referencia temporal.",
+          "Campos que exigem validacao de intervalo minimo e maximo de datas.",
+          "Selecao de data em formularios com contexto de calendario."
+        ],
+        "avoidUseCases": [
+          "Texto livre ou descricoes; nesses casos prefira SgInputText ou SgInputTextArea.",
+          "Numeros ou valores monetarios; nesses casos prefira SgInputNumber ou SgInputCurrency.",
+          "Escolhas estruturadas sem contexto temporal; nesses casos prefira select ou combobox."
+        ],
+        "synonyms": [
+          "date input",
+          "calendar field",
+          "deadline input",
+          "schedule date"
+        ],
+        "relatedEntityFields": [
+          "date",
+          "startDate",
+          "endDate",
+          "deadline",
+          "dueDate",
+          "birthDate"
+        ],
+        "compositionHints": [
+          "Combinar com SgButton para filtros por periodo e formulários com datas.",
+          "Usar dentro de SgPanel para blocos de agendamento ou dados temporais."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0.15,
+          "date": 0.98,
+          "number": 0,
+          "denseLayout": 0.7
+        }
+      }
+    },
+    {
+      "componentId": "form.input.datetime",
+      "exportName": "SgInputDateTime",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "form.input.datetime",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgInputDateTime",
+        "slug": "sg-input-date-time",
+        "displayName": "SgInputDateTime",
+        "category": "input",
+        "subcategory": "datetime",
+        "description": "Campo de data e hora que entrega e recebe instantes ISO 8601 em UTC, exibindo a hora no fuso escolhido, com limites, passo de minutos e validacao.",
+        "tags": [
+          "form",
+          "date",
+          "time",
+          "datetime",
+          "rhf"
+        ],
+        "capabilities": [
+          "rhf",
+          "controlled",
+          "min-max",
+          "time-zone",
+          "minute-step",
+          "iso-utc"
+        ],
+        "fieldSemantics": [
+          "dateTime",
+          "timestamp",
+          "schedule",
+          "appointment",
+          "deadline"
+        ],
+        "props": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true,
+            "description": "Identificador unico do campo.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": "Nome do campo para formularios.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": false,
+            "description": "Rotulo principal exibido ao usuario.",
+            "semanticRole": "label",
+            "bindable": true
+          },
+          {
+            "name": "value",
+            "type": "string | Date | null",
+            "required": false,
+            "description": "Instante controlado (ISO 8601 ou Date).",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "defaultValue",
+            "type": "string | Date | null",
+            "required": false,
+            "description": "Instante inicial (nao controlado).",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "required",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "description": "Marca o campo como obrigatorio.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "minDate",
+            "type": "string | Date",
+            "required": false,
+            "description": "Menor instante permitido.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxDate",
+            "type": "string | Date",
+            "required": false,
+            "description": "Maior instante permitido.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "timeZone",
+            "type": "string",
+            "required": false,
+            "default": "local",
+            "description": "Fuso do campo: local, UTC, deslocamento (+03:00) ou nome IANA.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "showSeconds",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "description": "Mostra e aceita segundos.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "minuteStep",
+            "type": "number",
+            "required": false,
+            "description": "Passo dos minutos (5, 10, 15, 30).",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "onChange",
+            "type": "(value: string | null, local: string) => void",
+            "required": false,
+            "description": "Instante ISO UTC (ou null) e texto local do campo.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "alwaysFloat",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "clearButton",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "error",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "filled",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "hintText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "iconButtons",
+            "type": "ReactNode[]",
+            "required": false
+          },
+          {
+            "name": "labelAlign",
+            "type": "\"start\" | \"center\" | \"end\"",
+            "required": false
+          },
+          {
+            "name": "labelPosition",
+            "type": "\"top\" | \"left\" | \"float\"",
+            "required": false
+          },
+          {
+            "name": "labelText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "labelWidth",
+            "type": "string | number",
+            "required": false
+          },
+          {
+            "name": "maxLength",
+            "type": "number",
+            "required": false
+          },
+          {
+            "name": "maxLengthMessage",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "minLength",
+            "type": "number",
+            "required": false
+          },
+          {
+            "name": "minLengthMessage",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "minNumberOfWords",
+            "type": "number",
+            "required": false
+          },
+          {
+            "name": "minNumberOfWordsMessage",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "onClear",
+            "type": "(() => void)",
+            "required": false
+          },
+          {
+            "name": "onEnter",
+            "type": "((() => void) & (() => void))",
+            "required": false,
+            "description": "Disparado ao receber foco — padrao seedgrid."
+          },
+          {
+            "name": "onExit",
+            "type": "((() => void) & (() => void))",
+            "required": false,
+            "description": "Disparado ao perder o foco (apos validacao) — padrao seedgrid."
+          },
+          {
+            "name": "onValidation",
+            "type": "((message: string | null) => void)",
+            "required": false
+          },
+          {
+            "name": "placeholder",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "prefixIcon",
+            "type": "ReactNode",
+            "required": false
+          },
+          {
+            "name": "prefixText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "readOnly",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "requiredMessage",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "showCharCounter",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "suffixText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "textInputType",
+            "type": "\"none\" | \"text\" | \"email\" | \"search\" | \"tel\" | \"url\" | \"numeric\" | \"decimal\"",
+            "required": false
+          },
+          {
+            "name": "validateOnBlur",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "validation",
+            "type": "((value: string) => string | null)",
+            "required": false
+          },
+          {
+            "name": "width",
+            "type": "string | number",
+            "required": false
+          },
+          {
+            "name": "withBorder",
+            "type": "boolean",
+            "required": false
+          }
+        ],
+        "states": [
+          "default",
+          "focused",
+          "disabled",
+          "readOnly",
+          "error"
+        ],
+        "examples": [
+          {
+            "id": "basic",
+            "title": "Basico",
+            "file": "apps/showcase/src/app/components/sg-input-date-time/samples/basico.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/sg-input-date-time/sg-input-date-time.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-input-date-time",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "field.datetime",
+          "acceptsDataBinding": true,
+          "defaultProps": {
+            "labelPosition": "float",
+            "clearButton": true
+          }
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Agendamentos, compromissos e prazos que exigem data e hora.",
+          "Campos de timestamp que precisam trafegar como instante UTC.",
+          "Formularios com limites de data e hora e fuso explicito."
+        ],
+        "avoidUseCases": [
+          "Somente data; prefira SgInputDate.",
+          "Somente hora do dia sem data; prefira um campo de hora.",
+          "Texto livre; prefira SgInputText."
+        ],
+        "synonyms": [
+          "datetime input",
+          "date time picker",
+          "timestamp field",
+          "appointment field"
+        ],
+        "relatedEntityFields": [
+          "createdAt",
+          "scheduledAt",
+          "startsAt",
+          "endsAt",
+          "dueAt",
+          "timestamp"
+        ],
+        "compositionHints": [
+          "Combinar dois campos (inicio/fim) com minDate/maxDate para intervalos.",
+          "Usar dentro de SgPanel em formularios de agenda."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0.1,
+          "date": 0.95,
+          "number": 0,
+          "denseLayout": 0.7
+        }
+      }
+    },
+    {
+      "componentId": "form.input.file-upload",
+      "exportName": "SgFileUpload",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "form.input.file-upload",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgFileUpload",
+        "slug": "sg-file-upload",
+        "displayName": "SgFileUpload",
+        "category": "input",
+        "subcategory": "file",
+        "description": "Seleciona um ou varios arquivos (clique ou arrastar e soltar), confere o tipo pelo conteudo e valida quantidade e tamanho (por arquivo e total). Mostra a lista com o icone do tipo e permite remover. Nao envia nada ao servidor: entrega os arquivos ao pai.",
+        "tags": [
+          "form",
+          "file",
+          "upload",
+          "attachment",
+          "document",
+          "pdf",
+          "spreadsheet",
+          "rhf"
+        ],
+        "capabilities": [
+          "rhf",
+          "controlled",
+          "drag-and-drop",
+          "multiple",
+          "validation"
+        ],
+        "fieldSemantics": [
+          "file",
+          "attachment",
+          "document",
+          "upload",
+          "pdf",
+          "spreadsheet"
+        ],
+        "props": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true,
+            "description": "Identificador unico do campo.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": "Nome do campo para formularios.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": false,
+            "description": "Rotulo exibido acima da area.",
+            "semanticRole": "label",
+            "bindable": true
+          },
+          {
+            "name": "value",
+            "type": "SgFileValue[] | null",
+            "required": false,
+            "description": "Arquivos controlados (sempre lista; um arquivo = lista de um). Um arquivo ja salvo entra como { name, url }.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "mediaType",
+            "type": "MediaType[]",
+            "required": false,
+            "description": "Tipos aceitos: image, video, audio, pdf, doc, docx, xls, xlsx, ppt, pptx, csv, txt, zip ou all. O tipo e conferido pelo conteudo do arquivo.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "accept",
+            "type": "string",
+            "required": false,
+            "description": "Tipos extras em texto livre (.pdf, image/png, image/*), separados por virgula; soma-se ao mediaType.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxFiles",
+            "type": "number",
+            "required": false,
+            "default": 1,
+            "description": "Quantos arquivos o campo guarda. Com 1, escolher outro substitui; maior que 1 liga a selecao multipla.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxSizePerFile",
+            "type": "SizeLimit",
+            "required": false,
+            "description": "Tamanho maximo de cada arquivo: bytes (numero) ou texto com unidade (\"500KB\", \"1.5MB\", \"1GB\").",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxSizeTotal",
+            "type": "SizeLimit",
+            "required": false,
+            "description": "Tamanho maximo da soma dos arquivos: bytes (numero) ou texto com unidade.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Desabilita a escolha e a remocao.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "onChange",
+            "type": "(files: SgFileValue[]) => void",
+            "required": false,
+            "description": "Lista de arquivos validos apos escolher ou remover.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onError",
+            "type": "(code: FileErrorCode, message: string, fileName: string) => void",
+            "required": false,
+            "description": "Arquivo recusado (type, size, total, count). Os demais seguem validos.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "defaultValue",
+            "type": "SgFileValue[]",
+            "required": false,
+            "description": "Arquivos iniciais (campo nao controlado)."
+          },
+          {
+            "name": "dropManyTextKey",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "dropTextKey",
+            "type": "string",
+            "required": false,
+            "description": "Chaves de i18n do texto da area vazia (um arquivo / varios)."
+          },
+          {
+            "name": "error",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "extraCheck",
+            "type": "((file: File, info: { mime: string; }) => Promise<SgFileRejection | null>)",
+            "required": false,
+            "description": "Regra extra, assincrona, por arquivo (depois da conferencia de tipo). E como o SgImageUpload confere dimensao."
+          },
+          {
+            "name": "hintText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "keyPrefix",
+            "type": "string",
+            "required": false,
+            "description": "Prefixo do `data-sg` dos elementos internos (`sg-file`, `sg-image`)."
+          },
+          {
+            "name": "labelText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "onEnter",
+            "type": "(() => void)",
+            "required": false
+          },
+          {
+            "name": "onExit",
+            "type": "(() => void)",
+            "required": false
+          },
+          {
+            "name": "pickerAccept",
+            "type": "string",
+            "required": false,
+            "description": "Valor do atributo `accept` do seletor do navegador (padrao: derivado de mediaType/accept)."
+          },
+          {
+            "name": "readOnly",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "required",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "requiredMessage",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "thumbnailBuilder",
+            "type": "((file: SgFileValue, size: number) => ReactNode)",
+            "required": false,
+            "description": "Miniatura de cada arquivo (sem ela, a lista usa o icone do tipo)."
+          },
+          {
+            "name": "thumbnailSize",
+            "type": "number",
+            "required": false,
+            "description": "Lado da miniatura em px (padrao 96)."
+          },
+          {
+            "name": "typeNames",
+            "type": "string",
+            "required": false,
+            "description": "Texto dos tipos aceitos na mensagem de tipo recusado (padrao: mediaType/accept)."
+          }
+        ],
+        "states": [
+          "default",
+          "focused",
+          "loading",
+          "disabled",
+          "readOnly",
+          "error"
+        ],
+        "examples": [
+          {
+            "id": "basic",
+            "title": "Basico",
+            "file": "apps/showcase/src/app/components/sg-file-upload/samples/basico.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "many",
+            "title": "Varios arquivos",
+            "file": "apps/showcase/src/app/components/sg-file-upload/samples/varios.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/sg-file-upload/sg-file-upload.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-file-upload",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "field.file",
+          "acceptsDataBinding": true,
+          "defaultProps": {}
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Anexar um ou varios documentos (PDF, planilhas, apresentacoes, zip) a um cadastro ou solicitacao.",
+          "Escolher arquivos validando tipo (pelo conteudo), quantidade e tamanho antes de enviar.",
+          "Formularios que precisam de arquivos como campo."
+        ],
+        "avoidUseCases": [
+          "Fotos e imagens com miniatura, dimensao minima ou proporcao; para isso use SgImageUpload.",
+          "Capturar pela camera do dispositivo; para isso use SgCameraCapture.",
+          "Envio ao servidor ou progresso de upload; nao fazem parte do componente."
+        ],
+        "synonyms": [
+          "file upload",
+          "attachment",
+          "anexar arquivo",
+          "upload de arquivo",
+          "documento",
+          "file picker"
+        ],
+        "relatedEntityFields": [
+          "attachment",
+          "document",
+          "file",
+          "contract",
+          "invoice",
+          "receipt"
+        ],
+        "compositionHints": [
+          "Envie os arquivos recebidos em onChange pelo servico de arquivos do host; o componente nunca envia sozinho.",
+          "Para imagens com miniatura e regras de dimensao, use SgImageUpload (composicao deste componente)."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0.1,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0.4
+        }
+      }
+    },
+    {
+      "componentId": "form.input.image-upload",
+      "exportName": "SgImageUpload",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "form.input.image-upload",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgImageUpload",
+        "slug": "sg-image-upload",
+        "displayName": "SgImageUpload",
+        "category": "input",
+        "subcategory": "file",
+        "description": "Seleciona uma ou varias imagens (clique ou arrastar e soltar), valida tipo (pelo conteudo), tamanho, dimensao minima e proporcao, mostra as miniaturas e permite remover. Composicao do SgFileUpload. Nao envia nada ao servidor: entrega os arquivos ao pai.",
+        "tags": [
+          "form",
+          "image",
+          "upload",
+          "photo",
+          "avatar",
+          "file",
+          "rhf"
+        ],
+        "capabilities": [
+          "rhf",
+          "controlled",
+          "drag-and-drop",
+          "preview",
+          "validation"
+        ],
+        "fieldSemantics": [
+          "image",
+          "photo",
+          "avatar",
+          "logo",
+          "picture",
+          "attachment"
+        ],
+        "props": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true,
+            "description": "Identificador unico do campo.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": false,
+            "description": "Nome do campo para formularios.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": false,
+            "description": "Rotulo exibido acima da area.",
+            "semanticRole": "label",
+            "bindable": true
+          },
+          {
+            "name": "value",
+            "type": "SgFileValue[] | null",
+            "required": false,
+            "description": "Imagens controladas (sempre lista; uma imagem = lista de uma). Uma imagem ja salva entra como { name, url }.",
+            "semanticRole": "data",
+            "bindable": true
+          },
+          {
+            "name": "accept",
+            "type": "string",
+            "required": false,
+            "description": "Restringe os formatos de imagem em texto livre (.png, image/jpeg), separados por virgula.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxFiles",
+            "type": "number",
+            "required": false,
+            "default": 1,
+            "description": "Quantas imagens o campo guarda. Com 1, escolher outra substitui; maior que 1 liga a selecao multipla e a grade de miniaturas.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxSizePerFile",
+            "type": "SizeLimit",
+            "required": false,
+            "description": "Tamanho maximo de cada imagem: bytes (numero) ou texto com unidade (\"500KB\", \"2MB\").",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "maxSizeTotal",
+            "type": "SizeLimit",
+            "required": false,
+            "description": "Tamanho maximo da soma das imagens: bytes (numero) ou texto com unidade.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "minWidth",
+            "type": "number",
+            "required": false,
+            "description": "Largura minima em px.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "minHeight",
+            "type": "number",
+            "required": false,
+            "description": "Altura minima em px.",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "aspect",
+            "type": "number",
+            "required": false,
+            "description": "Proporcao largura/altura exigida (1 = quadrada).",
+            "semanticRole": "validation",
+            "bindable": true
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Desabilita a escolha e a remocao.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "onChange",
+            "type": "(files: SgFileValue[]) => void",
+            "required": false,
+            "description": "Lista de imagens validas apos escolher ou remover.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onError",
+            "type": "(code: FileErrorCode, message: string, fileName: string) => void",
+            "required": false,
+            "description": "Imagem recusada (type, size, total, count, dimension, aspect). As demais seguem validas.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "defaultValue",
+            "type": "SgFileValue[]",
+            "required": false,
+            "description": "Arquivos iniciais (campo nao controlado)."
+          },
+          {
+            "name": "error",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "hintText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "labelText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "onEnter",
+            "type": "(() => void)",
+            "required": false
+          },
+          {
+            "name": "onExit",
+            "type": "(() => void)",
+            "required": false
+          },
+          {
+            "name": "previewHeight",
+            "type": "number",
+            "required": false,
+            "description": "Altura da miniatura em px (padrao 160; na grade, no maximo 120)."
+          },
+          {
+            "name": "readOnly",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "required",
+            "type": "boolean",
+            "required": false
+          },
+          {
+            "name": "requiredMessage",
+            "type": "string",
+            "required": false
+          }
+        ],
+        "states": [
+          "default",
+          "focused",
+          "loading",
+          "disabled",
+          "readOnly",
+          "error"
+        ],
+        "examples": [
+          {
+            "id": "basic",
+            "title": "Basico",
+            "file": "apps/showcase/src/app/components/sg-image-upload/samples/basico.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "many",
+            "title": "Varias imagens",
+            "file": "apps/showcase/src/app/components/sg-image-upload/samples/varias.tsx.sample",
+            "kind": "sample"
+          },
+          {
+            "id": "playground",
+            "title": "Playground",
+            "file": "apps/showcase/src/app/components/sg-image-upload/sg-image-upload.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-image-upload",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "field.image",
+          "acceptsDataBinding": true,
+          "defaultProps": {}
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "Foto de perfil, avatar, logotipo ou foto de documento com pre-visualizacao.",
+          "Escolher uma ou varias imagens validando tipo, tamanho e dimensao antes de enviar.",
+          "Formularios que precisam de imagens como campo."
+        ],
+        "avoidUseCases": [
+          "Arquivos que nao sao imagem (PDF, planilhas); nesses casos use SgFileUpload.",
+          "Capturar pela camera do dispositivo; para isso use SgCameraCapture.",
+          "Recorte ou compressao de imagem; nao fazem parte do componente."
+        ],
+        "synonyms": [
+          "image upload",
+          "photo upload",
+          "avatar picker",
+          "enviar foto",
+          "upload de imagem",
+          "logo upload"
+        ],
+        "relatedEntityFields": [
+          "photo",
+          "avatar",
+          "logo",
+          "image",
+          "picture",
+          "documentPhoto"
+        ],
+        "compositionHints": [
+          "Envie os arquivos recebidos em onChange pelo servico de arquivos do host; o componente nunca envia sozinho.",
+          "Combine com SgPanel e SgInputText em cadastros de pessoa ou produto."
+        ],
+        "rankingSignals": {
+          "freeText": 0,
+          "structuredChoice": 0.1,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0.4
+        }
+      }
+    },
+    {
+      "componentId": "form.input.camera-capture",
+      "exportName": "SgCameraCapture",
+      "sgMeta": {
+        "version": "0.1",
+        "componentId": "form.input.camera-capture",
+        "package": "@seedgrid/fe-components",
+        "exportName": "SgCameraCapture",
+        "slug": "sg-camera-capture",
+        "displayName": "SgCameraCapture",
+        "category": "input",
+        "subcategory": "camera",
+        "description": "Pre-visualizacao da camera com guia de enquadramento (oval ou retangulo), alternancia entre frontal e traseira e captura que devolve a imagem ao pai. Mostra os estados sem permissao e sem camera. Nao envia nada ao servidor.",
+        "tags": [
+          "camera",
+          "photo",
+          "capture",
+          "selfie",
+          "getUserMedia",
+          "input"
+        ],
+        "capabilities": [
+          "camera",
+          "preview",
+          "guide-overlay",
+          "switch-camera",
+          "capture"
+        ],
+        "fieldSemantics": [
+          "photo",
+          "selfie",
+          "picture",
+          "documentPhoto",
+          "avatar"
+        ],
+        "props": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true,
+            "description": "Identificador unico do componente.",
+            "semanticRole": "data",
+            "bindable": false
+          },
+          {
+            "name": "label",
+            "type": "string",
+            "required": false,
+            "description": "Rotulo exibido acima da pre-visualizacao.",
+            "semanticRole": "label",
+            "bindable": true
+          },
+          {
+            "name": "facing",
+            "type": "\"user\" | \"environment\"",
+            "required": false,
+            "default": "user",
+            "description": "Camera inicial: frontal (user) ou traseira (environment).",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "guide",
+            "type": "\"none\" | \"oval\" | \"rect\"",
+            "required": false,
+            "default": "none",
+            "description": "Guia de enquadramento sobre a pre-visualizacao.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "resolution",
+            "type": "\"low\" | \"medium\" | \"high\"",
+            "required": false,
+            "default": "medium",
+            "description": "Resolucao pedida (640x480, 1280x720, 1920x1080).",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "allowSwitch",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Mostra o botao de alternar entre frontal e traseira.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "previewHeight",
+            "type": "number",
+            "required": false,
+            "default": 320,
+            "description": "Altura da pre-visualizacao em px.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false,
+            "default": true,
+            "description": "Nao abre a camera nem permite capturar.",
+            "semanticRole": "appearance",
+            "bindable": true
+          },
+          {
+            "name": "onCapture",
+            "type": "(image: Blob) => void",
+            "required": false,
+            "description": "Imagem JPEG capturada.",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "onError",
+            "type": "(code, message) => void",
+            "required": false,
+            "description": "Camera indisponivel (permission, noCamera, failed).",
+            "semanticRole": "event",
+            "bindable": false
+          },
+          {
+            "name": "hintText",
+            "type": "string",
+            "required": false
+          },
+          {
+            "name": "labelText",
+            "type": "string",
+            "required": false
+          }
+        ],
+        "states": [
+          "default",
+          "starting",
+          "ready",
+          "permission",
+          "noCamera",
+          "failed",
+          "disabled"
+        ],
+        "examples": [
+          {
+            "id": "basic",
+            "title": "Basico",
+            "file": "apps/showcase/src/app/components/sg-camera-capture/samples/basico.tsx.sample",
             "kind": "sample"
           },
           {
             "id": "playground",
             "title": "Playground",
-            "file": "apps/showcase/src/app/components/sg-input-date/sg-input-date.tsx.playground",
+            "file": "apps/showcase/src/app/components/sg-camera-capture/sg-camera-capture.tsx.playground",
             "kind": "playground"
           }
         ],
         "showcase": {
-          "route": "/components/sg-input-date",
+          "route": "/components/sg-camera-capture",
           "hasPlayground": true,
           "hasPropsTable": true
         },
         "sdui": {
-          "rendererType": "field.date",
-          "acceptsDataBinding": true,
-          "defaultProps": {
-            "labelPosition": "float",
-            "clearButton": true
-          }
+          "rendererType": "field.camera",
+          "acceptsDataBinding": false,
+          "defaultProps": {}
         }
       },
       "aiHints": {
         "version": "0.1",
         "preferredUseCases": [
-          "Captura de datas de vencimento, agendamento, cadastro e referencia temporal.",
-          "Campos que exigem validacao de intervalo minimo e maximo de datas.",
-          "Selecao de data em formularios com contexto de calendario."
+          "Tirar foto na hora (selfie, foto de documento, portaria) com guia de enquadramento.",
+          "Fluxos que precisam da camera do dispositivo e de tratamento de permissao negada.",
+          "Capturar uma imagem para entregar ao host enviar."
         ],
         "avoidUseCases": [
-          "Texto livre ou descricoes; nesses casos prefira SgInputText ou SgInputTextArea.",
-          "Numeros ou valores monetarios; nesses casos prefira SgInputNumber ou SgInputCurrency.",
-          "Escolhas estruturadas sem contexto temporal; nesses casos prefira select ou combobox."
+          "Escolher uma imagem ja existente; para isso use SgImageUpload.",
+          "Gravar video ou audio; o componente captura apenas fotos.",
+          "Analise de qualidade ou reconhecimento facial; isso e do host."
         ],
         "synonyms": [
-          "date input",
-          "calendar field",
-          "deadline input",
-          "schedule date"
+          "camera",
+          "tirar foto",
+          "captura de foto",
+          "selfie",
+          "webcam",
+          "take photo"
         ],
         "relatedEntityFields": [
-          "date",
-          "startDate",
-          "endDate",
-          "deadline",
-          "dueDate",
-          "birthDate"
+          "photo",
+          "selfie",
+          "documentPhoto",
+          "avatar",
+          "picture"
         ],
         "compositionHints": [
-          "Combinar com SgButton para filtros por periodo e formulários com datas.",
-          "Usar dentro de SgPanel para blocos de agendamento ou dados temporais."
+          "Combine com SgImageUpload: camera para tirar na hora, upload para escolher da galeria.",
+          "Envie o Blob recebido em onCapture pelo servico de arquivos do host."
         ],
         "rankingSignals": {
           "freeText": 0,
-          "structuredChoice": 0.15,
-          "date": 0.98,
+          "structuredChoice": 0,
+          "date": 0,
           "number": 0,
-          "denseLayout": 0.7
+          "denseLayout": 0.3
         }
       }
     },
@@ -6862,10 +8054,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -6910,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
           },
           {
@@ -7134,7 +8326,7 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -7341,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
@@ -7390,7 +8582,7 @@
               "BIMESTER"
             ],
             "locale": "pt-BR",
-            "disabled": false,
+            "enabled": true,
             "required": false
           }
         }
@@ -7507,10 +8699,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -7555,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
           },
           {
@@ -7812,7 +9004,7 @@
             "bindable": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -7972,10 +9164,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -8212,10 +9404,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -8400,10 +9592,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -8588,7 +9780,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -9175,7 +10367,7 @@
           "acceptsDataBinding": true,
           "defaultProps": {
             "checked": false,
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -9297,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
           },
@@ -9500,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
@@ -9774,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
@@ -9854,7 +11046,7 @@
           "defaultProps": {
             "severity": "primary",
             "appearance": "solid",
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -10004,7 +11196,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -10381,7 +11573,7 @@
             "required": false
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false
           },
@@ -13603,11 +14795,6 @@
             "type": "SgCardPosition",
             "required": false
           },
-          {
-            "name": "disabled",
-            "type": "boolean",
-            "required": false
-          },
           {
             "name": "draggable",
             "type": "boolean",
@@ -13618,6 +14805,11 @@
             "type": "string",
             "required": false
           },
+          {
+            "name": "enabled",
+            "type": "boolean",
+            "required": false
+          },
           {
             "name": "footer",
             "type": "ReactNode",
@@ -15713,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
@@ -15764,7 +16956,7 @@
           "acceptsDataBinding": true,
           "defaultProps": {
             "hidden": false,
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -16459,10 +17651,10 @@
             "bindable": true
           },
           {
-            "name": "disabled",
+            "name": "enabled",
             "type": "boolean",
             "required": false,
-            "default": false,
+            "default": true,
             "description": "Desabilita interacao.",
             "semanticRole": "behavior",
             "bindable": true
@@ -16500,7 +17692,7 @@
           "defaultProps": {
             "showLabel": false,
             "severity": "plain",
-            "disabled": false
+            "enabled": true
           }
         }
       },
@@ -18460,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",