@seedgrid/fe-components 2026.4.11 → 2026.4.13

package/dist/ai-meta/types.d.ts

@@ -0,0 +1,58 @@
+export type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+export type SgMetaExampleV0 = {
+    id: string;
+    title: string;
+    file: string;
+    kind: "sample" | "playground";
+};
+export type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: "@seedgrid/fe-components";
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: "input" | "action" | "layout" | "feedback" | "navigation" | "data" | "provider" | "hook" | "gadget";
+    subcategory?: string;
+    description: string;
+    tags?: string[];
+    capabilities?: string[];
+    fieldSemantics?: string[];
+    props?: SgMetaPropV0[];
+    states?: string[];
+    examples?: SgMetaExampleV0[];
+    showcase?: {
+        route: string;
+        hasPlayground: boolean;
+        hasPropsTable: boolean;
+    };
+    sdui?: {
+        rendererType: string;
+        acceptsDataBinding?: boolean;
+        defaultProps?: Record<string, unknown>;
+    };
+};
+export type SgAiHintsV0 = {
+    version: "0.1";
+    preferredUseCases: string[];
+    avoidUseCases?: string[];
+    synonyms?: string[];
+    relatedEntityFields?: string[];
+    compositionHints?: string[];
+    rankingSignals?: {
+        freeText?: number;
+        structuredChoice?: number;
+        date?: number;
+        number?: number;
+        denseLayout?: number;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/ai-meta/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai-meta/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,yBAAyB,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9G,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,OAAO,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACxC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,KAAK,CAAC;IACf,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC"}

package/dist/ai-meta/types.js

@@ -0,0 +1 @@
+export {};

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

package/dist/buttons/SgButton.meta.d.ts.map

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

package/dist/buttons/SgButton.meta.js

@@ -0,0 +1,139 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "action.button",
+    package: "@seedgrid/fe-components",
+    exportName: "SgButton",
+    slug: "sg-button",
+    displayName: "SgButton",
+    category: "action",
+    subcategory: "button",
+    description: "Botao de acao com suporte a severity, appearance, shape, loading e icones para acoes principais e secundarias.",
+    tags: ["action", "button", "trigger", "cta"],
+    capabilities: ["trigger", "submit", "severity", "appearance", "loading", "icon-support"],
+    fieldSemantics: ["primaryAction", "secondaryAction", "submit", "confirm", "dismiss"],
+    props: [
+        {
+            name: "label",
+            type: "ReactNode",
+            description: "Conteudo textual principal do botao.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "info" | "warning" | "help" | "danger"',
+            default: "primary",
+            description: "Define o peso visual e semantico da acao.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "appearance",
+            type: '"solid" | "outline" | "ghost"',
+            default: "solid",
+            description: "Variante visual base do botao.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "type",
+            type: '"button" | "submit" | "reset"',
+            default: "button",
+            description: "Comportamento HTML da acao dentro de formularios.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "loading",
+            type: "boolean",
+            default: false,
+            description: "Exibe spinner e bloqueia interacao enquanto a acao esta em progresso.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "disabled",
+            type: "boolean",
+            default: false,
+            description: "Desabilita a interacao do botao.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "leftIcon",
+            type: "ReactNode",
+            description: "Icone exibido antes do label.",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "rightIcon",
+            type: "ReactNode",
+            description: "Icone exibido depois do label.",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "onClick",
+            type: "MouseEventHandler<HTMLButtonElement>",
+            description: "Callback disparado quando a acao e executada.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["default", "disabled", "loading"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-button/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-button/sg-button.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-button",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "action.button",
+        acceptsDataBinding: true,
+        defaultProps: {
+            appearance: "solid",
+            severity: "primary",
+            type: "button"
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Acoes primarias e secundarias em formularios e telas CRUD.",
+        "Submit, confirmacao, salvar, cancelar e outras acoes explicitas do usuario.",
+        "Chamadas para acao com feedback visual de loading."
+    ],
+    avoidUseCases: [
+        "Agrupar conteudo ou estruturar layout; nesses casos prefira SgPanel, SgCard ou SgStack.",
+        "Captura de dados; nesses casos prefira componentes de input.",
+        "Blocos de navegacao complexa; nesses casos prefira componentes de menu ou breadcrumb."
+    ],
+    synonyms: ["button", "cta", "action button", "submit button"],
+    relatedEntityFields: ["submit", "save", "cancel", "confirm", "delete"],
+    compositionHints: [
+        "Combinar com SgInputText e outros campos em formularios.",
+        "Usar dentro de SgPanel ou SgDialog para acoes contextuais."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.4
+    }
+};

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

package/dist/buttons/SgFloatActionButton.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgFloatActionButton.meta.d.ts","sourceRoot":"","sources":["../../src/buttons/SgFloatActionButton.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/buttons/SgFloatActionButton.meta.js

@@ -0,0 +1,132 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "action.float-button",
+    package: "@seedgrid/fe-components",
+    exportName: "SgFloatActionButton",
+    slug: "sg-float-action-button",
+    displayName: "SgFloatActionButton",
+    category: "action",
+    subcategory: "floating-action-button",
+    description: "Botao de acao flutuante para tarefas de alto destaque, com suporte a hint, posicao fixa e expansao de acoes secundarias.",
+    tags: ["action", "floating", "fab", "quick-action", "overlay"],
+    capabilities: ["floating-position", "quick-action", "action-groups", "hint", "drag-drop", "auto-hide"],
+    fieldSemantics: ["floatingAction", "quickAction", "primaryAction", "contextAction"],
+    props: [
+        {
+            name: "icon",
+            type: "ReactNode",
+            required: true,
+            description: "Icone principal exibido no FAB.",
+            semanticRole: "label",
+            bindable: false
+        },
+        {
+            name: "actions",
+            type: "SgFABAction[]",
+            description: "Acoes secundarias exibidas a partir do botao flutuante.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "position",
+            type: '"bottom-right" | "bottom-left" | "top-right" | "top-left"',
+            default: "bottom-right",
+            description: "Posicao do FAB na area visivel.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "hint",
+            type: "string",
+            description: "Rotulo textual complementar exibido como hint.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "info" | "warning" | "help" | "danger"',
+            default: "primary",
+            description: "Peso visual da acao flutuante.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "disabled",
+            type: "boolean",
+            default: false,
+            description: "Desabilita a acao principal e as acoes derivadas.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "loading",
+            type: "boolean",
+            default: false,
+            description: "Exibe estado de carregamento no FAB.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "onClick",
+            type: "() => void",
+            description: "Callback da acao principal do FAB.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["default", "disabled", "loading", "expanded", "dragging"],
+    examples: [
+        {
+            id: "positions",
+            title: "Positions",
+            file: "apps/showcase/src/app/components/sg-float-action-button/samples/positions.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-float-action-button/sg-float-action-button.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-float-action-button",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "action.float-button",
+        acceptsDataBinding: true,
+        defaultProps: {
+            position: "bottom-right",
+            severity: "primary",
+            autoHideOnScroll: false
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Acoes rapidas de alto destaque que precisam permanecer visiveis na tela.",
+        "Criar, adicionar ou abrir fluxos principais em layouts mobile e dashboards.",
+        "Menus compactos de acoes contextuais com expansao radial ou linear."
+    ],
+    avoidUseCases: [
+        "Acoes comuns de formulario em linha; nesses casos prefira SgButton ou SgSplitButton.",
+        "Agrupar conteudo ou criar secoes visuais; nesses casos prefira componentes de layout.",
+        "Capturar dados do usuario; nesses casos prefira componentes de input."
+    ],
+    synonyms: ["fab", "floating action button", "quick action button", "floating cta"],
+    relatedEntityFields: ["createAction", "quickActions", "floatingMenu", "primaryShortcut"],
+    compositionHints: [
+        "Usar sobre SgPanel, SgCard ou telas longas como atalho de acao principal.",
+        "Combinar com listas e datatables quando a acao precisa ficar sempre acessivel."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.8
+    }
+};

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

package/dist/buttons/SgSplitButton.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgSplitButton.meta.d.ts","sourceRoot":"","sources":["../../src/buttons/SgSplitButton.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/buttons/SgSplitButton.meta.js

@@ -0,0 +1,132 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "action.split-button",
+    package: "@seedgrid/fe-components",
+    exportName: "SgSplitButton",
+    slug: "sg-split-button",
+    displayName: "SgSplitButton",
+    category: "action",
+    subcategory: "split-button",
+    description: "Botao de acao com trigger principal e menu secundario acoplado para variacoes contextuais da mesma tarefa.",
+    tags: ["action", "button", "menu", "dropdown", "cta"],
+    capabilities: ["primary-action", "secondary-actions", "menu-items", "severity", "loading", "disabled"],
+    fieldSemantics: ["primaryAction", "secondaryAction", "menuAction", "contextAction"],
+    props: [
+        {
+            name: "label",
+            type: "ReactNode",
+            description: "Conteudo textual principal da acao.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "items",
+            type: "SgSplitButtonItem[]",
+            required: true,
+            description: "Lista de acoes secundarias exibidas no menu dropdown.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "info" | "warning" | "help" | "danger"',
+            default: "primary",
+            description: "Peso visual e semantico da acao principal.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "appearance",
+            type: '"solid" | "outline" | "ghost"',
+            default: "solid",
+            description: "Variante visual base do split button.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "disabled",
+            type: "boolean",
+            default: false,
+            description: "Desabilita a acao principal e o menu secundario.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "loading",
+            type: "boolean",
+            default: false,
+            description: "Exibe estado de carregamento na acao principal.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "leftIcon",
+            type: "ReactNode",
+            description: "Icone exibido junto do label principal.",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "onClick",
+            type: "() => void",
+            description: "Callback disparado na acao principal.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["default", "disabled", "loading", "menu-open"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-split-button/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-split-button/sg-split-button.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-split-button",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "action.split-button",
+        acceptsDataBinding: true,
+        defaultProps: {
+            severity: "primary",
+            appearance: "solid",
+            disabled: false
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Acoes com um caminho principal e opcoes secundarias relacionadas no mesmo contexto.",
+        "Fluxos como salvar, exportar, compartilhar ou criar com variacoes de execucao.",
+        "Toolbars e rodapes que precisam reduzir repeticao de botoes de acao."
+    ],
+    avoidUseCases: [
+        "Acoes simples com uma unica intencao; nesses casos prefira SgButton.",
+        "Estruturar layout ou agrupar conteudo; nesses casos prefira SgPanel, SgCard ou SgAccordion.",
+        "Capturar dados do usuario; nesses casos prefira componentes de input."
+    ],
+    synonyms: ["split button", "dropdown action button", "menu button", "compound action"],
+    relatedEntityFields: ["saveActions", "exportActions", "shareActions", "createActions"],
+    compositionHints: [
+        "Usar com SgPanel e SgCard em cabecalhos de bloco ou areas de acao.",
+        "Combinar com componentes de input em formularios com variacoes de submit."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.7
+    }
+};

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

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

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

package/dist/commons/SgAvatar.meta.js

@@ -0,0 +1,123 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.avatar",
+    package: "@seedgrid/fe-components",
+    exportName: "SgAvatar",
+    slug: "sg-avatar",
+    displayName: "SgAvatar",
+    category: "feedback",
+    subcategory: "avatar",
+    description: "Representacao visual compacta de pessoa, usuario ou entidade por imagem, iniciais, icone ou fallback.",
+    tags: ["feedback", "avatar", "profile", "identity", "user"],
+    capabilities: ["image-avatar", "fallback", "initials", "grouping", "severity"],
+    fieldSemantics: ["identity", "userAvatar", "profileImage", "entityMarker"],
+    props: [
+        {
+            name: "src",
+            type: "string",
+            description: "URL da imagem principal do avatar.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "alt",
+            type: "string",
+            description: "Texto alternativo da imagem do avatar.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "label",
+            type: "ReactNode",
+            description: "Conteudo textual usado como iniciais ou identificacao visual.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "fallback",
+            type: "ReactNode",
+            description: "Conteudo de fallback quando nao ha imagem.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "size",
+            type: '"xs" | "sm" | "md" | "lg" | "xl"',
+            default: "md",
+            description: "Escala visual do avatar.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "shape",
+            type: '"circle" | "square"',
+            default: "circle",
+            description: "Forma visual do avatar.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "warning" | "danger" | "info" | "neutral" | "custom"',
+            default: "primary",
+            description: "Tom visual do avatar quando nao ha imagem.",
+            semanticRole: "appearance",
+            bindable: true
+        }
+    ],
+    states: ["default", "image", "fallback", "disabled"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-avatar/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-avatar/sg-avatar.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-avatar",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.avatar",
+        acceptsDataBinding: true,
+        defaultProps: {
+            size: "md",
+            shape: "circle",
+            bordered: true
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Representar usuarios, pessoas e entidades em listas, cards e cabecalhos.",
+        "Exibir imagem de perfil, iniciais ou fallback visual de identidade.",
+        "Agrupar membros de equipe ou participantes com avatar group."
+    ],
+    avoidUseCases: [
+        "Status textuais ou contadores; nesses casos prefira SgBadge.",
+        "Acoes clicaveis principais; nesses casos prefira botao.",
+        "Conteudo longo ou secao de layout."
+    ],
+    synonyms: ["avatar", "profile image", "user avatar", "identity badge"],
+    relatedEntityFields: ["avatar", "photo", "profileImage", "user", "owner"],
+    compositionHints: [
+        "Usar com SgBadge para status de usuario e com SgCard em cabecalhos.",
+        "Combinar com SgMenu e breadcrumbs de perfil quando houver contexto de usuario."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.7
+    }
+};

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"SgAvatarGroup.meta.d.ts","sourceRoot":"","sources":["../../src/commons/SgAvatarGroup.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"}