@seedgrid/fe-components 2026.11.1 → 2026.11.2

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

@@ -5038,6 +5038,1186 @@
         }
       }
     },
+    {
+      "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": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "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": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "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": "disabled",
+            "type": "boolean",
+            "required": false,
+            "default": false,
+            "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-camera-capture/sg-camera-capture.tsx.playground",
+            "kind": "playground"
+          }
+        ],
+        "showcase": {
+          "route": "/components/sg-camera-capture",
+          "hasPlayground": true,
+          "hasPropsTable": true
+        },
+        "sdui": {
+          "rendererType": "field.camera",
+          "acceptsDataBinding": false,
+          "defaultProps": {}
+        }
+      },
+      "aiHints": {
+        "version": "0.1",
+        "preferredUseCases": [
+          "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": [
+          "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": [
+          "camera",
+          "tirar foto",
+          "captura de foto",
+          "selfie",
+          "webcam",
+          "take photo"
+        ],
+        "relatedEntityFields": [
+          "photo",
+          "selfie",
+          "documentPhoto",
+          "avatar",
+          "picture"
+        ],
+        "compositionHints": [
+          "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,
+          "date": 0,
+          "number": 0,
+          "denseLayout": 0.3
+        }
+      }
+    },
     {
       "componentId": "form.input.email",
       "exportName": "SgInputEmail",