@seedgrid/fe-components 2026.11.1 → 2026.11.3

package/dist/inputs/SgFileUpload.meta.js

@@ -0,0 +1,71 @@
+export const 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", description: "Nome do campo para formularios.", semanticRole: "data", bindable: true },
+        { name: "label", type: "string", description: "Rotulo exibido acima da area.", semanticRole: "label", bindable: true },
+        { name: "value", type: "SgFileValue[] | null", 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[]", 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", 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", 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", description: "Tamanho maximo de cada arquivo: bytes (numero) ou texto com unidade (\"500KB\", \"1.5MB\", \"1GB\").", semanticRole: "validation", bindable: true },
+        { name: "maxSizeTotal", type: "SizeLimit", description: "Tamanho maximo da soma dos arquivos: bytes (numero) ou texto com unidade.", semanticRole: "validation", bindable: true },
+        { name: "enabled", type: "boolean", default: true, description: "Desabilita a escolha e a remocao.", semanticRole: "appearance", bindable: true },
+        { name: "onChange", type: "(files: SgFileValue[]) => void", description: "Lista de arquivos validos apos escolher ou remover.", semanticRole: "event", bindable: false },
+        { name: "onError", type: "(code: FileErrorCode, message: string, fileName: string) => void", description: "Arquivo recusado (type, size, total, count). Os demais seguem validos.", semanticRole: "event", bindable: false }
+    ],
+    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: {} }
+};
+export const 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 }
+};

package/dist/inputs/SgImageUpload.d.ts

@@ -0,0 +1,20 @@
+import { type SgFileUploadProps } from "./SgFileUpload";
+/**
+ * SgImageUpload (P133, refeito no P141 como COMPOSICAO do SgFileUpload): so imagens (`mediaType: ["image"]`, tipo
+ * conferido pelo conteudo), miniaturas no lugar do icone e as regras que so existem para imagem: largura/altura
+ * minimas e proporcao. Valor = lista (uma imagem = lista de uma); `maxFiles` maior que 1 mostra a grade.
+ */
+export type SgImageUploadProps = Omit<SgFileUploadProps, "mediaType" | "extraCheck" | "thumbnailBuilder" | "thumbnailSize" | "dropTextKey" | "dropManyTextKey" | "typeNames" | "pickerAccept" | "keyPrefix"> & {
+    /** Restringe os formatos de imagem em texto livre (`.png`, `image/jpeg`), separados por virgula. */
+    accept?: string;
+    /** Largura minima em px. */
+    minWidth?: number;
+    /** Altura minima em px. */
+    minHeight?: number;
+    /** Proporcao largura/altura exigida (1 = quadrada, 16 / 9). */
+    aspect?: number;
+    /** Altura da miniatura em px (padrao 160; na grade, no maximo 120). */
+    previewHeight?: number;
+};
+export declare function SgImageUpload(props: SgImageUploadProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SgImageUpload.d.ts.map

package/dist/inputs/SgImageUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgImageUpload.d.ts","sourceRoot":"","sources":["../../src/inputs/SgImageUpload.tsx"],"names":[],"mappings":"AAOA,OAAO,EAAsC,KAAK,iBAAiB,EAAoB,MAAM,gBAAgB,CAAC;AAE9G;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,iBAAiB,EACjB,WAAW,GAAG,YAAY,GAAG,kBAAkB,GAAG,eAAe,GAAG,aAAa,GAAG,iBAAiB,GAAG,WAAW,GAAG,cAAc,GAAG,WAAW,CACnJ,GAAG;IACF,oGAAoG;IACpG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAqDF,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CAgDtD"}

package/dist/inputs/SgImageUpload.js

@@ -0,0 +1,74 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { ImageOff } from "lucide-react";
+import { t, useComponentsI18n } from "../i18n";
+import { formatAspect, validateImage } from "./imageUploadLogic";
+import { matchesMedia } from "./fileUploadLogic";
+import { SgFileUpload } from "./SgFileUpload";
+function readDimensions(file) {
+    return new Promise((resolve) => {
+        const url = URL.createObjectURL(file);
+        const img = new Image();
+        img.onload = () => {
+            URL.revokeObjectURL(url);
+            resolve({ width: img.naturalWidth, height: img.naturalHeight });
+        };
+        img.onerror = () => {
+            URL.revokeObjectURL(url);
+            resolve(null);
+        };
+        img.src = url;
+    });
+}
+function Thumbnail(props) {
+    const { file, id, side } = props;
+    const [url, setUrl] = React.useState(null);
+    const [broken, setBroken] = React.useState(false);
+    React.useEffect(() => {
+        setBroken(false);
+        if (typeof File !== "undefined" && file instanceof File) {
+            const objectUrl = URL.createObjectURL(file);
+            setUrl(objectUrl);
+            return () => URL.revokeObjectURL(objectUrl);
+        }
+        setUrl("url" in file && file.url ? file.url : null);
+        return undefined;
+    }, [file]);
+    if (!url || broken) {
+        return (_jsx("span", { className: "flex size-full items-center justify-center bg-muted/40 text-muted-foreground", children: _jsx(ImageOff, { className: "size-5", "aria-hidden": "true" }) }));
+    }
+    return (
+    // eslint-disable-next-line @next/next/no-img-element
+    _jsx("img", { src: url, alt: file.name, "data-sg": `sg-image-preview-${id}-${file.name}`, width: side, height: side, onError: () => setBroken(true), className: "size-full object-cover" }));
+}
+export function SgImageUpload(props) {
+    const i18n = useComponentsI18n();
+    const { accept, minWidth, minHeight, aspect, previewHeight = 160, maxFiles, id, ...rest } = props;
+    const multi = (maxFiles ?? 1) > 1;
+    const side = multi && previewHeight > 120 ? 120 : previewHeight;
+    const check = async (file, info) => {
+        if ((accept ?? "").trim() && !matchesMedia(file.name, info.mime, undefined, accept)) {
+            return { code: "type", message: t(i18n, "components.inputs.fileupload.type", { types: (accept ?? "").trim() }) };
+        }
+        const needsDimensions = minWidth !== undefined || minHeight !== undefined || aspect !== undefined;
+        if (!needsDimensions)
+            return null;
+        const dims = await readDimensions(file);
+        const code = validateImage({ name: "", type: "", size: file.size, width: dims?.width, height: dims?.height }, { accept: "", minWidth, minHeight, aspect });
+        if (code === "dimension") {
+            return {
+                code,
+                message: t(i18n, "components.inputs.imageupload.dimension", {
+                    minWidth: String(minWidth ?? 0),
+                    minHeight: String(minHeight ?? 0)
+                })
+            };
+        }
+        if (code === "aspect") {
+            return { code, message: t(i18n, "components.inputs.imageupload.aspect", { aspect: formatAspect(aspect ?? 1) }) };
+        }
+        return null;
+    };
+    return (_jsx(SgFileUpload, { ...rest, id: id, maxFiles: maxFiles, keyPrefix: "sg-image", mediaType: ["image"], typeNames: (accept ?? "").trim() ? (accept ?? "").trim() : "image", dropTextKey: "components.inputs.imageupload.drop", dropManyTextKey: "components.inputs.imageupload.dropMany", pickerAccept: (accept ?? "").trim() ? (accept ?? "").trim() : "image/*", extraCheck: check, thumbnailBuilder: (file, size) => _jsx(Thumbnail, { file: file, id: id, side: size }), thumbnailSize: side }));
+}

package/dist/inputs/SgImageUpload.meta.d.ts

@@ -0,0 +1,4 @@
+import type { SgAiHintsV0, SgMetaV0 } from "../ai-meta/types";
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+//# sourceMappingURL=SgImageUpload.meta.d.ts.map

package/dist/inputs/SgImageUpload.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgImageUpload.meta.d.ts","sourceRoot":"","sources":["../../src/inputs/SgImageUpload.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAqDpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/inputs/SgImageUpload.meta.js

@@ -0,0 +1,73 @@
+export const 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", description: "Nome do campo para formularios.", semanticRole: "data", bindable: true },
+        { name: "label", type: "string", description: "Rotulo exibido acima da area.", semanticRole: "label", bindable: true },
+        { name: "value", type: "SgFileValue[] | null", 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", description: "Restringe os formatos de imagem em texto livre (.png, image/jpeg), separados por virgula.", semanticRole: "validation", bindable: true },
+        { name: "maxFiles", type: "number", 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", description: "Tamanho maximo de cada imagem: bytes (numero) ou texto com unidade (\"500KB\", \"2MB\").", semanticRole: "validation", bindable: true },
+        { name: "maxSizeTotal", type: "SizeLimit", description: "Tamanho maximo da soma das imagens: bytes (numero) ou texto com unidade.", semanticRole: "validation", bindable: true },
+        { name: "minWidth", type: "number", description: "Largura minima em px.", semanticRole: "validation", bindable: true },
+        { name: "minHeight", type: "number", description: "Altura minima em px.", semanticRole: "validation", bindable: true },
+        { name: "aspect", type: "number", description: "Proporcao largura/altura exigida (1 = quadrada).", semanticRole: "validation", bindable: true },
+        { name: "enabled", type: "boolean", default: true, description: "Desabilita a escolha e a remocao.", semanticRole: "appearance", bindable: true },
+        { name: "onChange", type: "(files: SgFileValue[]) => void", description: "Lista de imagens validas apos escolher ou remover.", semanticRole: "event", bindable: false },
+        { name: "onError", type: "(code: FileErrorCode, message: string, fileName: string) => void", description: "Imagem recusada (type, size, total, count, dimension, aspect). As demais seguem validas.", semanticRole: "event", bindable: 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: {} }
+};
+export const 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 }
+};

package/dist/inputs/SgInputCurrency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgInputCurrency.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputCurrency.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGlF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC1D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACjD,CAAC;AAwmBF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CA8D1D;AAGD,eAAO,MAAM,cAAc,wBAAkB,CAAC;AAC9C,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"SgInputCurrency.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputCurrency.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGlF,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC1D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACjD,CAAC;AA8mBF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CA8D1D;AAGD,eAAO,MAAM,cAAc,wBAAkB,CAAC;AAC9C,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC"}

package/dist/inputs/SgInputCurrency.js

@@ -403,9 +403,11 @@ function SgInputCurrencyBase(props) {
         setCaretToEnd(inputRef.current);
     }, [displayValue]);
     const isDisabled = props.enabled === false || props.readOnly || inputProps.readOnly;
-    const canShowClear = (props.clearButton ?? true) && !isDisabled;
+    // O X so aparece com texto, mas o espaco dele fica sempre reservado (o texto do campo nao anda).
+    const clearEnabled = (props.clearButton ?? true) && !isDisabled;
+    const canShowClear = clearEnabled && isFilled;
     const iconButtonsCount = props.iconButtons?.length ?? 0;
-    const hasSuffix = canShowClear || iconButtonsCount > 0;
+    const hasSuffix = clearEnabled || iconButtonsCount > 0;
     const paddingLeft = props.prefixIcon ? "pl-10" : "px-3";
     const paddingRight = hasSuffix ? "pr-10" : "pr-3";
     const baseClass = "peer h-11 w-full rounded-md text-sm text-[var(--sg-input-fg,hsl(var(--foreground)))] caret-[var(--sg-input-fg,hsl(var(--foreground)))] placeholder-transparent disabled:text-[var(--sg-input-disabled-fg,hsl(var(--muted-foreground)))] disabled:bg-[var(--sg-input-disabled-bg,hsl(var(--muted)))] focus:outline-none text-right";
@@ -439,7 +441,7 @@ function SgInputCurrencyBase(props) {
         : undefined;
     const labelLeftStyle = prefixPaddingStyle ?? (props.prefixIcon ? "2.5rem" : "0.75rem");
     const iconButtonsPadding = iconButtonsCount > 0 ? `${iconButtonsCount * 1.5}rem` : "0rem";
-    const baseRightPadding = canShowClear ? "2rem" : "0.75rem";
+    const baseRightPadding = clearEnabled ? "2rem" : "0.75rem";
     const suffixActionGap = suffixText && hasSuffix ? "0.375rem" : "0rem";
     const suffixPaddingStyle = suffixText
         ? `calc(${suffixWidth}px + ${baseRightPadding} + ${iconButtonsPadding} + ${suffixActionGap})`
@@ -468,7 +470,7 @@ function SgInputCurrencyBase(props) {
                                 ? "peer-focus:-top-2 peer-focus:text-xs peer-focus:text-[hsl(var(--destructive))]"
                                 : "peer-focus:-top-2 peer-focus:text-xs peer-focus:text-[hsl(var(--primary))]",
                             props.labelClassName ?? ""
-                        ].join(" "), style: { left: labelLeftStyle }, children: [_jsx("span", { children: labelText }), props.required ? (_jsx("span", { className: "ml-1 text-[hsl(var(--destructive))]", "aria-hidden": "true", children: "*" })) : null] }), hasSuffix ? (_jsxs("span", { className: "absolute right-2 top-1/2 z-20 flex -translate-y-1/2 items-center gap-1", style: clearRightStyle ? { right: clearRightStyle } : undefined, children: [canShowClear ? (_jsx("button", { type: "button", tabIndex: -1, onMouseDown: (event) => event.preventDefault(), onClick: handleClear, className: "rounded px-1 text-xs text-foreground/60 hover:text-foreground", "aria-label": t(i18n, "components.actions.clear"), children: _jsx(X, { size: 16 }) })) : null, props.iconButtons?.map((node, index) => (_jsx("span", { children: node }, index)))] })) : null] }), _jsx("div", { className: "mt-1 flex items-center justify-between gap-2", children: _jsx(ErrorText, { message: props.error ?? internalError ?? undefined }) })] }));
+                        ].join(" "), style: { left: labelLeftStyle }, children: [_jsx("span", { children: labelText }), props.required ? (_jsx("span", { className: "ml-1 text-[hsl(var(--destructive))]", "aria-hidden": "true", children: "*" })) : null] }), hasSuffix ? (_jsxs("span", { className: "absolute right-2 top-1/2 z-20 flex -translate-y-1/2 items-center gap-1", style: clearRightStyle ? { right: clearRightStyle } : undefined, children: [clearEnabled ? (isFilled ? (_jsx("button", { type: "button", tabIndex: -1, onMouseDown: (event) => event.preventDefault(), onClick: handleClear, className: "rounded px-1 text-xs text-foreground/60 hover:text-foreground", "aria-label": t(i18n, "components.actions.clear"), children: _jsx(X, { size: 16 }) })) : (_jsx("span", { "aria-hidden": "true", className: "inline-block w-6" }))) : null, props.iconButtons?.map((node, index) => (_jsx("span", { children: node }, index)))] })) : null] }), _jsx("div", { className: "mt-1 flex items-center justify-between gap-2", children: _jsx(ErrorText, { message: props.error ?? internalError ?? undefined }) })] }));
 }
 export function SgInputCurrency(props) {
     const i18n = useComponentsI18n();

package/dist/inputs/SgInputDate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgInputDate.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputDate.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAKnE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IAC9D,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAoCF,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA0JlD"}
+{"version":3,"file":"SgInputDate.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputDate.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMnE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG;IAC9D,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAmCF,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,2CA0JlD"}

package/dist/inputs/SgInputDate.js

@@ -5,6 +5,7 @@ import { SgInputText } from "./SgInputText";
 import { resolveFieldError } from "../rhf";
 import { t, useComponentsI18n } from "../i18n";
 import { useDarkFlag } from "../gadgets/clock/themes/useDarkFlag";
+import { formatLocalizedDate } from "./dateTimeLogic";
 function toDateValue(value) {
     if (!value)
         return undefined;
@@ -16,12 +17,10 @@ function formatDateDisplay(value, locale) {
     const iso = toDateValue(value);
     if (!iso)
         return "";
-    if (locale === "en-US")
-        return iso;
-    const [year, month, day] = iso.split("-");
+    const [year, month, day] = iso.slice(0, 10).split("-");
     if (!year || !month || !day)
         return iso;
-    return `${day}/${month}/${year}`;
+    return formatLocalizedDate(Number(year), Number(month), Number(day), locale);
 }
 function parseDateValue(value) {
     const date = new Date(value);

package/dist/inputs/SgInputDateTime.d.ts

@@ -0,0 +1,29 @@
+import { type SgInputTextProps } from "./SgInputText";
+export type SgInputDateTimeProps = Omit<SgInputTextProps, "type" | "onChange"> & {
+    /** Instante controlado: ISO 8601 (com offset ou "Z") ou `Date`. `null`/"" limpa o campo. */
+    value?: string | Date | null;
+    /** Instante inicial (campo nao controlado). */
+    defaultValue?: string | Date | null;
+    /**
+     * Disparado a cada alteracao com o instante em ISO 8601 UTC (`2026-11-03T17:30:00.000Z`) ou `null` se o
+     * campo ficou vazio/incompleto/invalido; `local` e o texto do campo (`2026-11-03T14:30`) no fuso do campo.
+     */
+    onChange?: (value: string | null, local: string) => void;
+    /** Disparado ao receber foco — padrao seedgrid. */
+    onEnter?: () => void;
+    /** Disparado ao perder o foco (apos validacao) — padrao seedgrid. */
+    onExit?: () => void;
+    /** Menor instante permitido (ISO 8601 ou `Date`). */
+    minDate?: string | Date;
+    /** Maior instante permitido (ISO 8601 ou `Date`). */
+    maxDate?: string | Date;
+    /** Fuso em que o campo mostra e interpreta a hora: "local" (padrao), "UTC", "+03:00" ou nome IANA. */
+    timeZone?: string;
+    /** Mostra e aceita segundos. */
+    showSeconds?: boolean;
+    /** Passo dos minutos (1, 5, 10, 15, 30...). Ignorado com `showSeconds`. */
+    minuteStep?: number;
+    alwaysFloat?: boolean;
+};
+export declare function SgInputDateTime(props: SgInputDateTimeProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=SgInputDateTime.d.ts.map

package/dist/inputs/SgInputDateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgInputDateTime.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputDateTime.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYnE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IAC/E,4FAA4F;IAC5F,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sGAAsG;IACtG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AASF,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,2CAwK1D"}

package/dist/inputs/SgInputDateTime.js

@@ -0,0 +1,141 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React from "react";
+import { SgInputText } from "./SgInputText";
+import { resolveFieldError } from "../rhf";
+import { t, useComponentsI18n } from "../i18n";
+import { useDarkFlag } from "../gadgets/clock/themes/useDarkFlag";
+import { formatWallClock, instantToWallClock, snapMinutes, validateDateTime, wallClockToInstant } from "./dateTimeLogic";
+/** Teto do atributo HTML quando nao ha `maxDate` (o <input> aceitaria ano de 6 digitos). */
+const WIDGET_MAX = "9999-12-31T23:59";
+function localOf(value, timeZone, showSeconds) {
+    return instantToWallClock(value ?? undefined, timeZone, showSeconds);
+}
+export function SgInputDateTime(props) {
+    const i18n = useComponentsI18n();
+    const isDark = useDarkFlag();
+    const { value, defaultValue, onChange, minDate, maxDate, timeZone, showSeconds = false, minuteStep, inputProps, alwaysFloat, required, requiredMessage, validateOnBlur, validation, onValidation, error, ...rest } = props;
+    const rhfManaged = Boolean(rest.control && rest.name);
+    const controlled = value !== undefined;
+    const [innerLocal, setInnerLocal] = React.useState(() => localOf(defaultValue, timeZone, showSeconds));
+    const local = controlled ? localOf(value, timeZone, showSeconds) : innerLocal;
+    const labelText = rest.labelText ?? rest.label ?? "";
+    const [internalError, setInternalError] = React.useState(null);
+    const hasError = Boolean(error ?? internalError);
+    const [hasInteracted, setHasInteracted] = React.useState(false);
+    // Segmentos digitados pela metade: o <input type="datetime-local"> entrega "" (validity.badInput). Em modo controlado o
+    // React devolveria o `value` antigo e o campo voltaria ao valor anterior; enquanto parcial, o DOM segue sem ser reescrito.
+    const [partial, setPartial] = React.useState(false);
+    React.useEffect(() => {
+        setPartial(false);
+    }, [local]);
+    const minLocal = minDate ? instantToWallClock(minDate, timeZone, showSeconds) : undefined;
+    const maxLocal = maxDate ? instantToWallClock(maxDate, timeZone, showSeconds) : undefined;
+    const effectiveStep = showSeconds ? 1 : minuteStep && minuteStep > 1 ? minuteStep * 60 : undefined;
+    const runValidation = React.useCallback((text) => {
+        const report = (message) => {
+            setInternalError(message);
+            onValidation?.(message);
+        };
+        if (!text && required)
+            return report(requiredMessage ?? t(i18n, "components.inputs.required"));
+        if (!text)
+            return report(null);
+        const custom = validation?.(text) ?? null;
+        if (custom)
+            return report(custom);
+        const code = validateDateTime(text, { required, min: minDate, max: maxDate, timeZone });
+        if (code === "invalid")
+            return report(t(i18n, "components.inputs.datetime.invalid"));
+        if (code === "min" || code === "max" || code === "range") {
+            const min = minLocal ? formatWallClock(minLocal, i18n.locale, showSeconds) : "";
+            const max = maxLocal ? formatWallClock(maxLocal, i18n.locale, showSeconds) : "";
+            return report(code === "range"
+                ? t(i18n, "components.inputs.datetime.range", { min, max })
+                : code === "min"
+                    ? t(i18n, "components.inputs.datetime.min", { min })
+                    : t(i18n, "components.inputs.datetime.max", { max }));
+        }
+        return report(null);
+    }, [i18n, maxDate, maxLocal, minDate, minLocal, onValidation, required, requiredMessage, showSeconds, timeZone, validation]);
+    // A mensagem de erro e texto pronto: ao trocar o idioma ela e recalculada com o valor atual (sem esperar nova validacao).
+    const lastLocaleRef = React.useRef(i18n.locale);
+    const runValidationRef = React.useRef(runValidation);
+    runValidationRef.current = runValidation;
+    React.useEffect(() => {
+        if (lastLocaleRef.current === i18n.locale)
+            return;
+        lastLocaleRef.current = i18n.locale;
+        if (internalError !== null)
+            runValidationRef.current(local);
+    }, [i18n.locale, internalError, local]);
+    const emit = (text) => {
+        onChange?.(text ? wallClockToInstant(text, timeZone) : null, text);
+    };
+    const mergedInputProps = {
+        ...inputProps,
+        placeholder: " ",
+        min: minLocal,
+        max: maxLocal ?? WIDGET_MAX,
+        step: effectiveStep,
+        ...(rhfManaged ? {} : { value: partial ? "" : local }),
+        readOnly: inputProps?.readOnly,
+        onChange: (event) => {
+            const text = event.currentTarget.value;
+            setPartial(text === "" && Boolean(event.currentTarget.validity?.badInput));
+            setHasInteracted(true);
+            if (!controlled)
+                setInnerLocal(text);
+            if (validateOnBlur === false || internalError)
+                runValidation(text);
+            emit(text);
+            inputProps?.onChange?.(event);
+        },
+        onBlur: (event) => {
+            let text = event.currentTarget.value;
+            const snapped = snapMinutes(text, showSeconds ? undefined : minuteStep);
+            if (snapped !== text) {
+                text = snapped;
+                if (!controlled)
+                    setInnerLocal(text);
+                emit(text);
+            }
+            if ((validateOnBlur ?? true) || hasInteracted)
+                runValidation(text);
+            inputProps?.onBlur?.(event);
+        }
+    };
+    const inputClassName = (() => {
+        if (mergedInputProps.className)
+            return mergedInputProps.className;
+        const elevationClass = props.elevation === "none" ? "" : props.elevation === "md" ? "shadow-md" : props.elevation === "lg" ? "shadow-lg" : "shadow-sm";
+        const baseClass = "peer h-11 w-full rounded-md bg-[var(--sg-input-bg,hsl(var(--background)))] text-[var(--sg-input-fg,hsl(var(--foreground)))] caret-[var(--sg-input-fg,hsl(var(--foreground)))] pl-3 pr-7 py-2.5 text-sm placeholder-transparent focus:outline-none";
+        const borderClass = hasError
+            ? "border border-[hsl(var(--destructive))] focus:border-[hsl(var(--destructive))] focus:ring-2 focus:ring-[hsl(var(--destructive)/0.25)]"
+            : "border border-border focus:border-[hsl(var(--primary))] focus:ring-2 focus:ring-[hsl(var(--primary)/0.25)]";
+        return [baseClass, borderClass, elevationClass].filter(Boolean).join(" ");
+    })();
+    const wrapperClassName = ["relative", isDark ? "sg-datetime-dark" : "sg-datetime-light"].join(" ");
+    return (_jsxs("div", { className: wrapperClassName, children: [_jsx("style", { children: `
+        input[type="datetime-local"]::-webkit-calendar-picker-indicator {
+          cursor: pointer;
+        }
+        .sg-datetime-dark input[type="datetime-local"] {
+          color-scheme: dark;
+        }
+        .sg-datetime-light input[type="datetime-local"] {
+          color-scheme: light;
+        }
+      ` }), labelText ? (_jsx("label", { htmlFor: rest.id, className: [
+                    "pointer-events-none absolute left-3 top-0 z-10 -translate-y-1/2 bg-[var(--sg-input-bg,hsl(var(--background)))] px-1 text-[11px] font-medium leading-none",
+                    hasError ? "text-[hsl(var(--destructive))]" : "text-foreground/70"
+                ].join(" "), children: labelText })) : null, _jsx(SgInputText, { ...rest, type: "datetime-local", error: resolveFieldError(error, internalError ?? undefined), inputProps: mergedInputProps, className: inputClassName, labelClassName: "sr-only", onClear: () => {
+                    setInternalError(null);
+                    onValidation?.(null);
+                    setPartial(false);
+                    if (!controlled)
+                        setInnerLocal("");
+                    emit("");
+                    rest.onClear?.();
+                } })] }));
+}

package/dist/inputs/SgInputDateTime.meta.d.ts

@@ -0,0 +1,4 @@
+import type { SgAiHintsV0, SgMetaV0 } from "../ai-meta/types";
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+//# sourceMappingURL=SgInputDateTime.meta.d.ts.map

package/dist/inputs/SgInputDateTime.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgInputDateTime.meta.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputDateTime.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE9D,eAAO,MAAM,MAAM,EAAE,QAqDpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/inputs/SgInputDateTime.meta.js

@@ -0,0 +1,73 @@
+export const 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", description: "Nome do campo para formularios.", semanticRole: "data", bindable: true },
+        { name: "label", type: "string", description: "Rotulo principal exibido ao usuario.", semanticRole: "label", bindable: true },
+        { name: "value", type: "string | Date | null", description: "Instante controlado (ISO 8601 ou Date).", semanticRole: "data", bindable: true },
+        { name: "defaultValue", type: "string | Date | null", description: "Instante inicial (nao controlado).", semanticRole: "data", bindable: true },
+        { name: "required", type: "boolean", default: false, description: "Marca o campo como obrigatorio.", semanticRole: "validation", bindable: true },
+        { name: "minDate", type: "string | Date", description: "Menor instante permitido.", semanticRole: "validation", bindable: true },
+        { name: "maxDate", type: "string | Date", description: "Maior instante permitido.", semanticRole: "validation", bindable: true },
+        { name: "timeZone", type: "string", default: "local", description: "Fuso do campo: local, UTC, deslocamento (+03:00) ou nome IANA.", semanticRole: "data", bindable: true },
+        { name: "showSeconds", type: "boolean", default: false, description: "Mostra e aceita segundos.", semanticRole: "appearance", bindable: true },
+        { name: "minuteStep", type: "number", description: "Passo dos minutos (5, 10, 15, 30).", semanticRole: "validation", bindable: true },
+        { name: "onChange", type: "(value: string | null, local: string) => void", description: "Instante ISO UTC (ou null) e texto local do campo.", semanticRole: "event", bindable: 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 }
+    }
+};
+export const 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 }
+};

package/dist/inputs/SgInputNumber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SgInputNumber.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputNumber.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGlF,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC1D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACjD,CAAC;AA8lBF,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CA8DtD"}
+{"version":3,"file":"SgInputNumber.d.ts","sourceRoot":"","sources":["../../src/inputs/SgInputNumber.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGlF,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,KAAK,CAAC,sBAAsB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,GAAG;QAC1D,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;KACnC,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACjD,CAAC;AAomBF,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,2CA8DtD"}