@seedgrid/fe-components 2026.4.11 → 2026.4.13

package/dist/commons/SgAvatarGroup.meta.js

@@ -0,0 +1,46 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.avatar-group",
+    package: "@seedgrid/fe-components",
+    exportName: "SgAvatarGroup",
+    slug: "sg-avatar-group",
+    displayName: "SgAvatarGroup",
+    category: "feedback",
+    subcategory: "avatar-group",
+    description: "Agrupamento visual de avatares com sobreposicao, limite de itens e contador de participantes restantes.",
+    tags: ["feedback", "avatar", "group", "participants", "team"],
+    capabilities: ["avatar-stack", "overlap", "max-limit", "overflow-counter", "team-display"],
+    fieldSemantics: ["participants", "team", "members", "avatarStack", "collaborators"],
+    props: [
+        { name: "children", type: "ReactNode", required: true, description: "Lista de avatares exibidos no agrupamento.", semanticRole: "data", bindable: false },
+        { name: "max", type: "number", description: "Quantidade maxima de avatares visiveis antes do contador de overflow.", semanticRole: "behavior", bindable: true },
+        { name: "total", type: "number", description: "Quantidade total de participantes para calculo do overflow.", semanticRole: "value", bindable: true },
+        { name: "overlap", type: '"none" | "sm" | "md" | "lg"', default: "md", description: "Nivel de sobreposicao entre os avatares.", semanticRole: "appearance", bindable: true },
+        { name: "size", type: '"xs" | "sm" | "md" | "lg" | "xl"', default: "md", description: "Escala aplicada aos avatares do grupo.", semanticRole: "appearance", bindable: true },
+        { name: "shape", type: '"circle" | "square"', default: "circle", description: "Forma visual aplicada ao grupo de avatares.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["default", "overflow", "stacked"],
+    examples: [{ id: "avatar-group", title: "Avatar group", file: "apps/showcase/src/app/components/sg-avatar/samples/avatar-group.tsx.sample", kind: "sample" }],
+    showcase: { route: "/components/sg-avatar", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "feedback.avatar-group", acceptsDataBinding: true, defaultProps: { overlap: "md", size: "md", shape: "circle" } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir participantes, membros de equipe e colaboradores em cabecalhos e cards.",
+        "Representar grupos com limite visual e contador de itens adicionais.",
+        "Mostrar ownership, revisores ou pessoas associadas a uma entidade."
+    ],
+    avoidUseCases: [
+        "Uma unica identidade; nesses casos prefira SgAvatar.",
+        "Listas detalhadas de usuarios com texto e metadata; nesses casos prefira lista ou tabela.",
+        "Status textuais e contadores puros; nesses casos prefira SgBadge."
+    ],
+    synonyms: ["avatar group", "team avatars", "participant stack", "member avatars"],
+    relatedEntityFields: ["members", "participants", "reviewers", "owners", "team"],
+    compositionHints: [
+        "Usar com SgAvatar em listas, cards e cabecalhos de colaboracao.",
+        "Combinar com Badge ou Card quando houver destaque de contagem ou ownership."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0.2, denseLayout: 0.82 }
+};

package/dist/commons/SgBadge.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=SgBadge.meta.d.ts.map

package/dist/commons/SgBadge.meta.d.ts.map

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

package/dist/commons/SgBadge.meta.js

@@ -0,0 +1,132 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.badge",
+    package: "@seedgrid/fe-components",
+    exportName: "SgBadge",
+    slug: "sg-badge",
+    displayName: "SgBadge",
+    category: "feedback",
+    subcategory: "badge",
+    description: "Indicador compacto para status, contagens, rotulos curtos e destaque visual de pequenos estados.",
+    tags: ["feedback", "badge", "status", "counter", "label"],
+    capabilities: ["status-indicator", "counter", "severity", "variant", "removable", "dot"],
+    fieldSemantics: ["status", "counter", "tag", "indicator", "label"],
+    props: [
+        {
+            name: "value",
+            type: "ReactNode",
+            description: "Conteudo principal exibido dentro do badge.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "warning" | "danger" | "info" | "neutral" | "custom"',
+            default: "primary",
+            description: "Tom semantico do indicador.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "badgeStyle",
+            type: '"solid" | "soft" | "outline" | "ghost"',
+            default: "solid",
+            description: "Variante visual do badge.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "size",
+            type: '"xs" | "sm" | "md" | "lg"',
+            default: "md",
+            description: "Escala visual do badge.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "dot",
+            type: "boolean",
+            default: false,
+            description: "Exibe um pequeno marcador visual adicional.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "removable",
+            type: "boolean",
+            default: false,
+            description: "Permite remover o badge com um botao interno.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "onRemove",
+            type: "() => void",
+            description: "Callback disparado ao remover o badge.",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "onClick",
+            type: "(e: React.MouseEvent) => void",
+            description: "Callback disparado quando o badge e clicado.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["default", "disabled", "removable", "clickable"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-badge/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-badge/sg-badge.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-badge",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.badge",
+        acceptsDataBinding: true,
+        defaultProps: {
+            severity: "primary",
+            badgeStyle: "solid",
+            size: "md"
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir status curtos, contadores, tags e indicadores compactos.",
+        "Sinalizar estados como novo, ativo, pendente, erro ou quantidade.",
+        "Anotar cards, listas e cabecalhos com informacao de baixo peso."
+    ],
+    avoidUseCases: [
+        "Mensagens longas ou feedback detalhado; nesses casos prefira alertas ou dialogs.",
+        "Acoes principais; nesses casos prefira componentes de botao.",
+        "Agrupamento de conteudo; nesses casos prefira componentes de layout."
+    ],
+    synonyms: ["badge", "tag", "status chip", "counter badge"],
+    relatedEntityFields: ["status", "count", "label", "tag", "notificationCount"],
+    compositionHints: [
+        "Usar com SgCard, SgAvatar e listas para indicar estado ou contagem.",
+        "Combinar com SgButton ou menus quando houver contadores contextuais."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0.3,
+        denseLayout: 0.85
+    }
+};

package/dist/commons/SgBadgeOverlay.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=SgBadgeOverlay.meta.d.ts.map

package/dist/commons/SgBadgeOverlay.meta.d.ts.map

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

package/dist/commons/SgBadgeOverlay.meta.js

@@ -0,0 +1,46 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.badge-overlay",
+    package: "@seedgrid/fe-components",
+    exportName: "SgBadgeOverlay",
+    slug: "sg-badge-overlay",
+    displayName: "SgBadgeOverlay",
+    category: "feedback",
+    subcategory: "badge-overlay",
+    description: "Wrapper para sobrepor badges e indicadores compactos sobre avatares, icones e outros elementos visuais.",
+    tags: ["feedback", "badge", "overlay", "indicator"],
+    capabilities: ["overlay-indicator", "badge-positioning", "status-overlay"],
+    fieldSemantics: ["statusOverlay", "counterOverlay", "indicatorOverlay"],
+    props: [
+        { name: "children", type: "ReactNode", required: true, description: "Elemento base que recebera o badge sobreposto.", semanticRole: "data", bindable: false },
+        { name: "badge", type: "ReactNode", required: true, description: "Conteudo do indicador exibido sobre o elemento base.", semanticRole: "label", bindable: true },
+        { name: "placement", type: '"top-left" | "top-right" | "bottom-left" | "bottom-right" | "right" | "left" | "top" | "bottom"', default: "top-right", description: "Posicao do badge sobreposto.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["default"],
+    examples: [
+        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-badge-overlay/samples/basico.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-badge-overlay/sg-badge-overlay.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/sg-badge-overlay", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "feedback.badge-overlay", acceptsDataBinding: true, defaultProps: { placement: "top-right" } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Adicionar contadores ou estados sobre avatares, icones e botoes.",
+        "Indicar notificacoes, status online e pequenos marcadores contextuais.",
+        "Sobrepor badges sem alterar a estrutura do elemento base."
+    ],
+    avoidUseCases: [
+        "Badges independentes sem elemento base; nesses casos prefira SgBadge.",
+        "Conteudo longo ou estruturas de layout.",
+        "Fluxos de interacao complexos."
+    ],
+    synonyms: ["badge overlay", "notification overlay", "indicator overlay"],
+    relatedEntityFields: ["notificationCount", "statusOverlay", "avatarStatus"],
+    compositionHints: [
+        "Usar com SgAvatar, SgButton e icones de menu.",
+        "Combinar com SgBadge para reaproveitar o visual do indicador."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0.2, denseLayout: 0.75 }
+};

package/dist/commons/SgSkeleton.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=SgSkeleton.meta.d.ts.map

package/dist/commons/SgSkeleton.meta.d.ts.map

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

package/dist/commons/SgSkeleton.meta.js

@@ -0,0 +1,114 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.skeleton",
+    package: "@seedgrid/fe-components",
+    exportName: "SgSkeleton",
+    slug: "sg-skeleton",
+    displayName: "SgSkeleton",
+    category: "feedback",
+    subcategory: "skeleton",
+    description: "Placeholder visual para estados de carregamento, simulando texto, blocos e avatares antes da chegada dos dados reais.",
+    tags: ["feedback", "loading", "placeholder", "skeleton"],
+    capabilities: ["loading-state", "shape-variants", "animation", "size-control"],
+    fieldSemantics: ["loadingPlaceholder", "skeleton", "pendingContent", "progressiveLoading"],
+    props: [
+        {
+            name: "shape",
+            type: '"text" | "rectangle" | "rounded" | "square" | "circle"',
+            default: "text",
+            description: "Forma visual base do placeholder.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "animation",
+            type: '"wave" | "pulse" | "none"',
+            default: "wave",
+            description: "Animacao aplicada ao placeholder.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "width",
+            type: "number | string",
+            description: "Largura do placeholder.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "height",
+            type: "number | string",
+            description: "Altura do placeholder.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "size",
+            type: "number | string",
+            description: "Tamanho unico para placeholders quadrados ou circulares.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "borderRadius",
+            type: "number | string",
+            description: "Raio de borda customizado.",
+            semanticRole: "appearance",
+            bindable: true
+        }
+    ],
+    states: ["loading", "static"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-skeleton/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-skeleton/sg-skeleton.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-skeleton",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.skeleton",
+        acceptsDataBinding: false,
+        defaultProps: {
+            shape: "text",
+            animation: "wave"
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Representar carregamento de conteudo antes dos dados reais estarem disponiveis.",
+        "Simular listas, cards, tabelas e detalhes de perfil em estado pending.",
+        "Evitar layout shift durante carregamentos assíncronos."
+    ],
+    avoidUseCases: [
+        "Exibir feedback final de erro ou sucesso; nesses casos prefira componentes de alerta ou toast.",
+        "Conteudo real persistente; o skeleton e apenas placeholder.",
+        "Acoes e interacoes diretas do usuario."
+    ],
+    synonyms: ["skeleton", "loading placeholder", "content shimmer", "loading block"],
+    relatedEntityFields: ["loadingState", "pendingList", "pendingCard", "asyncPlaceholder"],
+    compositionHints: [
+        "Usar junto de SgCard, SgAvatar e SgDatatable para estados de carregamento.",
+        "Combinar varios skeletons em SgStack e SgGrid para simular layouts completos."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.8
+    }
+};

package/dist/commons/SgToastHost.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=SgToastHost.meta.d.ts.map

package/dist/commons/SgToastHost.meta.d.ts.map

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

package/dist/commons/SgToastHost.meta.js

@@ -0,0 +1,46 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.toast-host",
+    package: "@seedgrid/fe-components",
+    exportName: "SgToastHost",
+    slug: "sg-toast-host",
+    displayName: "SgToastHost",
+    category: "feedback",
+    subcategory: "toast-host",
+    description: "Ponto explicito de montagem para notificacoes toast, usado quando a aplicacao precisa controlar a localizacao ativa do host.",
+    tags: ["feedback", "toast", "host", "notification"],
+    capabilities: ["host-priority", "toast-mount-point", "custom-positioning"],
+    fieldSemantics: ["toastHost", "notificationMountPoint", "feedbackHost"],
+    props: [
+        { name: "position", type: '"top-right" | "top-left" | "top-center" | "bottom-right" | "bottom-left" | "bottom-center"', default: "top-right", description: "Posicao dos toasts renderizados por este host.", semanticRole: "appearance", bindable: true },
+        { name: "duration", type: "number", default: 4000, description: "Duracao padrao aplicada aos toasts deste host.", semanticRole: "behavior", bindable: true },
+        { name: "visibleToasts", type: "number", default: 6, description: "Quantidade maxima de toasts visiveis.", semanticRole: "behavior", bindable: true }
+    ],
+    states: ["inactive", "active-host"],
+    examples: [
+        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-toast-host/samples/basico.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-toast-host/sg-toast-host.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/sg-toast-host", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "feedback.toast-host", acceptsDataBinding: false, defaultProps: { position: "top-right" } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Definir explicitamente onde os toasts devem aparecer na arvore da aplicacao.",
+        "Priorizar um host local sobre um toaster global.",
+        "Layouts que precisam controlar o mount point de notificacoes."
+    ],
+    avoidUseCases: [
+        "Publicar notificacoes diretamente; para isso use a API `toast`.",
+        "Feedback inline ou modal.",
+        "Cenarios simples onde um unico SgToaster global basta."
+    ],
+    synonyms: ["toast host", "toast mount point", "notification host"],
+    relatedEntityFields: ["toastHost", "notificationHost", "layoutToasts"],
+    compositionHints: [
+        "Usar com `toast` e `SgToaster` em layouts com multiplos niveis.",
+        "Instalar um host por area quando a aplicacao precisar priorizar contexto local."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0, denseLayout: 0.5 }
+};

package/dist/commons/SgToaster.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=SgToaster.meta.d.ts.map

package/dist/commons/SgToaster.meta.d.ts.map

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

package/dist/commons/SgToaster.meta.js

@@ -0,0 +1,48 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.toaster",
+    package: "@seedgrid/fe-components",
+    exportName: "SgToaster",
+    slug: "sg-toaster",
+    displayName: "SgToaster",
+    category: "feedback",
+    subcategory: "toaster",
+    description: "Host visual de notificacoes toast globais, com controle de posicao, duracao, quantidade visivel e estilos ricos.",
+    tags: ["feedback", "toast", "notification", "toaster"],
+    capabilities: ["toast-hosting", "global-feedback", "positioning", "duration-control", "rich-colors"],
+    fieldSemantics: ["toastContainer", "notificationFeedback", "globalFeedback"],
+    props: [
+        { name: "position", type: '"top-right" | "top-left" | "top-center" | "bottom-right" | "bottom-left" | "bottom-center"', default: "top-right", description: "Posicao global do stack de toasts.", semanticRole: "appearance", bindable: true },
+        { name: "duration", type: "number", default: 4000, description: "Duracao padrao dos toasts em milissegundos.", semanticRole: "behavior", bindable: true },
+        { name: "visibleToasts", type: "number", default: 6, description: "Quantidade maxima de toasts visiveis simultaneamente.", semanticRole: "behavior", bindable: true },
+        { name: "closeButton", type: "boolean", default: true, description: "Exibe botao de fechar em cada toast.", semanticRole: "appearance", bindable: true },
+        { name: "richColors", type: "boolean", default: true, description: "Ativa paleta visual rica por tipo de toast.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["idle", "showing-toasts"],
+    examples: [
+        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-toaster/samples/basico.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-toaster/sg-toaster.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/sg-toaster", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "feedback.toaster", acceptsDataBinding: false, defaultProps: { position: "top-right", duration: 4000, visibleToasts: 6 } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir feedback global leve e nao bloqueante para sucesso, erro e informacao.",
+        "Notificar operacoes assincronas sem interromper o fluxo do usuario.",
+        "Centralizar a renderizacao de toasts em uma aplicacao."
+    ],
+    avoidUseCases: [
+        "Confirmacoes criticas; nesses casos prefira SgConfirmationDialog.",
+        "Conteudo modal ou detalhado; nesses casos prefira SgDialog.",
+        "Status persistentes dentro do layout; nesses casos prefira badge ou whistle."
+    ],
+    synonyms: ["toaster", "toast container", "toast notifications"],
+    relatedEntityFields: ["notifications", "toastFeedback", "globalMessages"],
+    compositionHints: [
+        "Usar com a API `toast` para publicar mensagens.",
+        "Combinar com SgToastHost quando for preciso controlar o ponto de renderizacao."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0, denseLayout: 0.6 }
+};

package/dist/commons/SgWhistleHost.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=SgWhistleHost.meta.d.ts.map

package/dist/commons/SgWhistleHost.meta.d.ts.map

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

package/dist/commons/SgWhistleHost.meta.js

@@ -0,0 +1,46 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.whistle-host",
+    package: "@seedgrid/fe-components",
+    exportName: "SgWhistleHost",
+    slug: "sg-whistle-host",
+    displayName: "SgWhistleHost",
+    category: "feedback",
+    subcategory: "whistle-host",
+    description: "Host de avisos persistentes ou semi-persistentes em pilha, com cores por severidade, acao opcional e controle de maximo visivel.",
+    tags: ["feedback", "alerts", "host", "inline-notifications"],
+    capabilities: ["alert-stacking", "severity-colors", "dismissible-items", "timed-dismiss"],
+    fieldSemantics: ["alertHost", "persistentFeedback", "stackedAlerts"],
+    props: [
+        { name: "max", type: "number", default: 4, description: "Quantidade maxima de whistle items visiveis.", semanticRole: "behavior", bindable: true },
+        { name: "newestOnTop", type: "boolean", default: false, description: "Inverte a ordem visual para mostrar os mais novos primeiro.", semanticRole: "behavior", bindable: true },
+        { name: "gap", type: "number", default: 12, description: "Espacamento entre os avisos renderizados.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["idle", "showing-alerts"],
+    examples: [
+        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/sg-whistle-host/samples/basico.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/sg-whistle-host/sg-whistle-host.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/sg-whistle-host", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "feedback.whistle-host", acceptsDataBinding: false, defaultProps: { max: 4, newestOnTop: false } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir avisos empilhados mais persistentes do que um toast.",
+        "Comunicar erros, warnings e mensagens operacionais inline em uma area fixa.",
+        "Agrupar alertas com acao e dismiss local."
+    ],
+    avoidUseCases: [
+        "Feedback ultraleve e efemero; nesses casos prefira toaster.",
+        "Modais de confirmacao.",
+        "Indicadores compactos como badge."
+    ],
+    synonyms: ["alert host", "message stack", "persistent notifications"],
+    relatedEntityFields: ["alerts", "warnings", "inlineMessages", "systemMessages"],
+    compositionHints: [
+        "Usar com a API `sgWhistle` para publicar avisos.",
+        "Combinar com SgCard ou SgPanel em dashboards operacionais."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0, denseLayout: 0.7 }
+};

package/dist/digits/discard-digit/SgDiscardDigit.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=SgDiscardDigit.meta.d.ts.map

package/dist/digits/discard-digit/SgDiscardDigit.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgDiscardDigit.meta.d.ts","sourceRoot":"","sources":["../../../src/digits/discard-digit/SgDiscardDigit.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,MAAM,EAAE,QA4BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/digits/discard-digit/SgDiscardDigit.meta.js

@@ -0,0 +1,48 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.digit.discard",
+    package: "@seedgrid/fe-components",
+    exportName: "SgDiscardDigit",
+    slug: "sg-discard-digit",
+    displayName: "SgDiscardDigit",
+    category: "gadget",
+    subcategory: "digit",
+    description: "Digito animado com transicao de descarte para representar mudanca de valores em displays compactos.",
+    tags: ["gadget", "digit", "discard", "display", "counter"],
+    capabilities: ["single-character-display", "discard-animation", "counter-composition", "custom-colors"],
+    fieldSemantics: ["digitDisplay", "counterDigit", "animatedCharacter", "transitionalMetric"],
+    props: [
+        { name: "value", type: "string", required: true, description: "Caractere exibido no display.", semanticRole: "value", bindable: true },
+        { name: "fontSize", type: "number", default: 72, description: "Escala visual do digito.", semanticRole: "appearance", bindable: true },
+        { name: "color", type: "string", description: "Cor do caractere.", semanticRole: "appearance", bindable: true },
+        { name: "backgroundColor", type: "string", description: "Cor do fundo do card.", semanticRole: "appearance", bindable: true },
+        { name: "className", type: "string", description: "Classes CSS adicionais.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["idle", "animating"],
+    examples: [
+        { id: "basic", title: "Basico", file: "apps/showcase/src/app/components/digits/sg-discard-digit/samples/basico.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/digits/sg-discard-digit/sg-discard-digit.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/digits/sg-discard-digit", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "gadget.digit.discard", acceptsDataBinding: true, defaultProps: { fontSize: 72 } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Displays de contagem com transicao visual mais expressiva.",
+        "Indicadores numericos compactos em dashboards.",
+        "Widgets que priorizam efeito de troca entre caracteres."
+    ],
+    avoidUseCases: [
+        "Entrada de dados do usuario.",
+        "Texto longo e leitura continua.",
+        "Tabelas e grids com muitas celulas."
+    ],
+    synonyms: ["discard digit", "animated digit", "counter digit"],
+    relatedEntityFields: ["digit", "counter", "score", "metric", "display"],
+    compositionHints: [
+        "Combinar varios SgDiscardDigit para relogios e contadores.",
+        "Usar com SgCard, SgPanel e widgets de destaque."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0.06, number: 0.66, denseLayout: 0.31 }
+};

package/dist/digits/fade-digit/SgFadeDigit.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=SgFadeDigit.meta.d.ts.map

package/dist/digits/fade-digit/SgFadeDigit.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgFadeDigit.meta.d.ts","sourceRoot":"","sources":["../../../src/digits/fade-digit/SgFadeDigit.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,eAAO,MAAM,MAAM,EAAE,QA4BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}