@seedgrid/fe-components 2026.4.12 → 2026.4.13

package/dist/menus/SgDockMenu.meta.js

@@ -0,0 +1,135 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "navigation.dock-menu",
+    package: "@seedgrid/fe-components",
+    exportName: "SgDockMenu",
+    slug: "sg-dock-menu",
+    displayName: "SgDockMenu",
+    category: "navigation",
+    subcategory: "dock-menu",
+    description: "Menu de acoes ou navegacao com estilo dock, suporte a badges, magnify, posicoes ancoradas e persistencia de arraste.",
+    tags: ["navigation", "menu", "dock", "actions", "launcher"],
+    capabilities: ["dock-layout", "anchored-navigation", "badges", "magnify", "drag-drop", "persistent-position"],
+    fieldSemantics: ["navigation", "dock", "quickActions", "appLauncher", "shortcutMenu"],
+    props: [
+        {
+            name: "items",
+            type: "SgDockMenuItem[]",
+            required: true,
+            description: "Itens exibidos no dock com icone, label, badge e acao.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "position",
+            type: '"left-top" | "left-center" | "left-bottom" | "center-top" | "center-bottom" | "right-top" | "right-center" | "right-bottom"',
+            default: "center-bottom",
+            description: "Posicionamento principal do dock na area alvo.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "enableDragDrop",
+            type: "boolean",
+            default: false,
+            description: "Permite reposicionamento manual do dock.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "showLabels",
+            type: "boolean",
+            default: true,
+            description: "Exibe labels contextuais dos itens.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "magnify",
+            type: "boolean",
+            default: true,
+            description: "Ativa efeito de ampliacao ao passar o mouse.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "itemSize",
+            type: "number",
+            default: 48,
+            description: "Tamanho visual padrao dos itens do dock.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "gap",
+            type: "number",
+            default: 16,
+            description: "Espacamento entre os itens do dock.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "zIndex",
+            type: "number",
+            default: 50,
+            description: "Camada visual usada quando o dock esta sobreposto.",
+            semanticRole: "behavior",
+            bindable: true
+        }
+    ],
+    states: ["default", "hovered", "dragging", "menu-open", "badged"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-dock-menu/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-dock-menu/sg-dock-menu.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-dock-menu",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "navigation.dock-menu",
+        acceptsDataBinding: true,
+        defaultProps: {
+            position: "center-bottom",
+            showLabels: true,
+            magnify: true
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Expor atalhos de navegacao e acoes frequentes em estilo dock.",
+        "Criar launcher de modulos, menus flutuantes e barras ancoradas com icones.",
+        "Exibir notificacoes contextuais com badges em menus persistentes."
+    ],
+    avoidUseCases: [
+        "Menus textuais extensos ou arvores hierarquicas; nesses casos prefira Menu ou TreeView.",
+        "Acoes unitarias simples; nesses casos prefira Button ou SplitButton.",
+        "Containers estruturais; nesses casos prefira Panel, Card ou Screen."
+    ],
+    synonyms: ["dock menu", "launcher", "quick menu", "floating dock"],
+    relatedEntityFields: ["shortcuts", "modules", "quickActions", "dockItems", "navigationItems"],
+    compositionHints: [
+        "Usar com Screen e Panel em shells de aplicacao.",
+        "Combinar com Badge para contadores de notificacao e estados contextuais."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0.55,
+        date: 0,
+        number: 0,
+        denseLayout: 0.9
+    }
+};

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

package/dist/overlay/SgConfirmationDialog.meta.d.ts.map

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

package/dist/overlay/SgConfirmationDialog.meta.js

@@ -0,0 +1,128 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.confirmation-dialog",
+    package: "@seedgrid/fe-components",
+    exportName: "SgConfirmationDialog",
+    slug: "sg-confirmation-dialog",
+    displayName: "SgConfirmationDialog",
+    category: "feedback",
+    subcategory: "confirmation-dialog",
+    description: "Dialog especializado em confirmacao de acoes sensiveis, com mensagem, severidade e botoes de confirmar e cancelar.",
+    tags: ["feedback", "confirmation", "dialog", "danger", "warning"],
+    capabilities: ["confirmation-flow", "confirm-cancel", "severity", "custom-buttons", "safe-defaults"],
+    fieldSemantics: ["confirmationDialog", "dangerConfirmation", "warningPrompt", "decisionModal"],
+    props: [
+        {
+            name: "open",
+            type: "boolean",
+            description: "Controla a abertura do dialog de confirmacao.",
+            semanticRole: "value",
+            bindable: true
+        },
+        {
+            name: "title",
+            type: "ReactNode",
+            description: "Titulo principal da confirmacao.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "message",
+            type: "ReactNode",
+            description: "Mensagem principal explicando o risco ou decisao.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "info" | "warning" | "help" | "danger" | "plain"',
+            default: "warning",
+            description: "Tom semantico da confirmacao.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "confirmButton",
+            type: "SgConfirmationDialogButtonConfig",
+            description: "Configuracao visual e comportamental do botao de confirmacao.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "cancelButton",
+            type: "SgConfirmationDialogButtonConfig",
+            description: "Configuracao visual e comportamental do botao de cancelamento.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "onConfirm",
+            type: "() => void",
+            description: "Callback disparado quando o usuario confirma a acao.",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "onCancel",
+            type: "() => void",
+            description: "Callback disparado quando o usuario cancela a acao.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["closed", "open", "confirming", "cancelling"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-confirmation-dialog/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-confirmation-dialog/sg-confirmation-dialog.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-confirmation-dialog",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.confirmation-dialog",
+        acceptsDataBinding: true,
+        defaultProps: {
+            severity: "warning",
+            closeOnCancel: true,
+            closeOnConfirm: true
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Confirmar acoes destrutivas, sensiveis ou irreversiveis.",
+        "Solicitar decisao binaria antes de excluir, revogar ou prosseguir.",
+        "Fluxos em que confirmacao e cancelamento precisam de semantica clara."
+    ],
+    avoidUseCases: [
+        "Conteudo modal generico sem necessidade de confirmacao; nesses casos prefira SgDialog.",
+        "Feedback apenas informativo; nesses casos prefira toast, badge ou alerta simples.",
+        "Captura direta de dados sem contexto de risco; nesses casos prefira formularios comuns."
+    ],
+    synonyms: ["confirmation dialog", "confirm modal", "danger prompt", "warning confirm"],
+    relatedEntityFields: ["deleteConfirm", "confirmAction", "unsavedChanges", "dangerousOperation"],
+    compositionHints: [
+        "Usar com SgButton para abrir a confirmacao a partir de acoes sensiveis.",
+        "Combinar com SgDialog apenas quando houver um fluxo modal maior ao redor."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.6
+    }
+};

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

package/dist/overlay/SgDialog.meta.d.ts.map

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

package/dist/overlay/SgDialog.meta.js

@@ -0,0 +1,130 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.dialog",
+    package: "@seedgrid/fe-components",
+    exportName: "SgDialog",
+    slug: "sg-dialog",
+    displayName: "SgDialog",
+    category: "feedback",
+    subcategory: "dialog",
+    description: "Overlay modal para apresentar conteudo focado, confirmacoes e fluxos curtos com controle de abertura, fechamento e severidade visual.",
+    tags: ["feedback", "dialog", "modal", "overlay", "focus"],
+    capabilities: ["modal", "controlled-open", "severity", "size", "animation", "auto-close"],
+    fieldSemantics: ["dialog", "modal", "overlay", "focusedContent", "interruption"],
+    props: [
+        {
+            name: "open",
+            type: "boolean",
+            description: "Controla a abertura do dialog em modo controlado.",
+            semanticRole: "value",
+            bindable: true
+        },
+        {
+            name: "onOpenChange",
+            type: "(open: boolean) => void",
+            description: "Callback disparado quando o estado de abertura muda.",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "title",
+            type: "ReactNode",
+            description: "Titulo principal do dialog.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "subtitle",
+            type: "ReactNode",
+            description: "Subtitulo complementar do dialog.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "children",
+            type: "ReactNode",
+            description: "Conteudo principal do corpo do dialog.",
+            semanticRole: "data",
+            bindable: false
+        },
+        {
+            name: "size",
+            type: '"sm" | "md" | "lg" | "xl" | "full"',
+            default: "md",
+            description: "Escala do container modal.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "severity",
+            type: '"primary" | "secondary" | "success" | "info" | "warning" | "help" | "danger" | "plain"',
+            default: "plain",
+            description: "Tom semantico do cabecalho e acentos visuais.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "closeOnOverlayClick",
+            type: "boolean",
+            default: true,
+            description: "Fecha o dialog ao clicar fora do conteudo.",
+            semanticRole: "behavior",
+            bindable: true
+        }
+    ],
+    states: ["closed", "open", "loading", "auto-close"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-dialog/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-dialog/sg-dialog.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-dialog",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.dialog",
+        acceptsDataBinding: true,
+        defaultProps: {
+            size: "md",
+            severity: "plain",
+            closeOnOverlayClick: true
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir conteudo focado que interrompe temporariamente o fluxo principal.",
+        "Abrir detalhes, formularios curtos, confirmacoes e avisos modais.",
+        "Cenarios com controle explicito de abertura e fechamento."
+    ],
+    avoidUseCases: [
+        "Feedback leve e nao bloqueante; nesses casos prefira toast ou badge.",
+        "Secoes permanentes da tela; nesses casos prefira componentes de layout.",
+        "Captura de um unico valor simples sem contexto modal; nesses casos prefira input direto."
+    ],
+    synonyms: ["dialog", "modal", "overlay modal", "popup dialog"],
+    relatedEntityFields: ["dialogState", "modalContent", "detailsOverlay", "editModal"],
+    compositionHints: [
+        "Usar com SgButton para gatilhos de abertura e acoes de confirmacao.",
+        "Combinar com SgStack e sgInput* para formularios modais curtos."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.7
+    }
+};

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

package/dist/overlay/SgPopup.meta.d.ts.map

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

package/dist/overlay/SgPopup.meta.js

@@ -0,0 +1,129 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "feedback.popup",
+    package: "@seedgrid/fe-components",
+    exportName: "SgPopup",
+    slug: "sg-popup",
+    displayName: "SgPopup",
+    category: "feedback",
+    subcategory: "popup",
+    description: "Overlay contextual ancorado a um elemento para exibir acoes, detalhes curtos ou conteudo complementar sem abrir um modal completo.",
+    tags: ["feedback", "popup", "overlay", "anchored", "contextual"],
+    capabilities: ["anchored-overlay", "auto-placement", "actions", "controlled-open", "outside-click-close"],
+    fieldSemantics: ["popup", "contextualOverlay", "anchoredContent", "quickActions"],
+    props: [
+        {
+            name: "anchorRef",
+            type: "React.RefObject<HTMLElement>",
+            required: true,
+            description: "Elemento ancora usado para posicionar o popup.",
+            semanticRole: "data",
+            bindable: false
+        },
+        {
+            name: "open",
+            type: "boolean",
+            description: "Controla a visibilidade do popup em modo controlado.",
+            semanticRole: "value",
+            bindable: true
+        },
+        {
+            name: "onOpenChange",
+            type: "(open: boolean) => void",
+            description: "Callback disparado quando o estado de abertura muda.",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "title",
+            type: "string",
+            description: "Titulo opcional do popup.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "subtitle",
+            type: "string",
+            description: "Subtitulo opcional do popup.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "actions",
+            type: "SgPopupAction[]",
+            description: "Lista de acoes contextuais renderizadas no popup.",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "placement",
+            type: '"auto" | "top" | "right" | "bottom" | "left"',
+            default: "auto",
+            description: "Posicionamento principal do popup em relacao a ancora.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "closeOnOutsideClick",
+            type: "boolean",
+            default: true,
+            description: "Fecha o popup quando o usuario clica fora dele.",
+            semanticRole: "behavior",
+            bindable: true
+        }
+    ],
+    states: ["closed", "open", "positioned"],
+    examples: [
+        {
+            id: "basic",
+            title: "Basico",
+            file: "apps/showcase/src/app/components/sg-popup/samples/basico.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "playground",
+            title: "Playground",
+            file: "apps/showcase/src/app/components/sg-popup/sg-popup.tsx.playground",
+            kind: "playground"
+        }
+    ],
+    showcase: {
+        route: "/components/sg-popup",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "feedback.popup",
+        acceptsDataBinding: true,
+        defaultProps: {
+            placement: "auto",
+            closeOnOutsideClick: true
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir conteudo contextual curto ancorado a um botao, campo ou item da interface.",
+        "Mostrar acoes rapidas, menus leves ou detalhes auxiliares sem bloquear a tela.",
+        "Cenarios em que um dialog seria pesado demais para o contexto."
+    ],
+    avoidUseCases: [
+        "Fluxos modais de confirmacao ou edicao; nesses casos prefira SgDialog ou SgConfirmationDialog.",
+        "Menus complexos de navegacao persistente; nesses casos prefira SgMenu.",
+        "Conteudo permanente de layout; nesses casos prefira componentes estruturais."
+    ],
+    synonyms: ["popup", "anchored popup", "context menu popup", "contextual overlay"],
+    relatedEntityFields: ["quickActions", "detailsPopup", "contextInfo", "anchorOverlay"],
+    compositionHints: [
+        "Usar com SgButton, SgSplitButton ou itens clicaveis como ancora.",
+        "Combinar com SgBadge ou SgAvatar para overlays contextuais compactos."
+    ],
+    rankingSignals: {
+        freeText: 0,
+        structuredChoice: 0,
+        date: 0,
+        number: 0,
+        denseLayout: 0.75
+    }
+};