@seedgrid/fe-components 2026.4.18 → 2026.4.20

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

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

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

package/dist/commons/dismissSgToast.meta.js

@@ -0,0 +1,69 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.dismiss-toast",
+    package: "@seedgrid/fe-components",
+    exportName: "dismissSgToast",
+    slug: "dismiss-sg-toast",
+    displayName: "dismissSgToast",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para fechar/remover um toast especifico ou todos os toasts. Complementa a funcao toast() para controle programatico.",
+    tags: ["hook", "toast", "notification", "dismiss"],
+    capabilities: ["dismiss-specific", "dismiss-all", "programmatic-control"],
+    fieldSemantics: ["dismissal", "notificationControl", "cleanup"],
+    props: [
+        {
+            name: "id",
+            type: "SgToastId | undefined",
+            description: "ID do toast a fechar. Se undefined, fecha todos os toasts.",
+            semanticRole: "data",
+            bindable: false
+        }
+    ],
+    states: ["dismissed", "all-dismissed"],
+    examples: [
+        {
+            id: "dismiss-one",
+            title: "Fechar um toast especifico",
+            file: "apps/showcase/src/app/components/toasts/samples/dismiss-one.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "dismiss-all",
+            title: "Fechar todos os toasts",
+            file: "apps/showcase/src/app/components/toasts/samples/dismiss-all.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/toasts",
+        hasPlayground: true,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Fechar um toast especifico quando o usuario clica em uma acao.",
+        "Limpar todos os toasts quando o usuario sai da pagina ou sessao.",
+        "Controlar o ciclo de vida de toasts programaticamente."
+    ],
+    avoidUseCases: [
+        "Fechar toasts cuja duracao ja expirou; o sistema faz isso automaticamente.",
+        "Usar sem ter disparado um toast antes; valide o ID."
+    ],
+    synonyms: ["dismiss toast", "close notification", "clear toast"],
+    relatedEntityFields: ["dismiss", "close", "cleanup"],
+    compositionHints: [
+        "Chamar apos uma acao do usuario.",
+        "Usar em cleanup de componentes para fechar toasts orphos.",
+        "Guardar o ID retornado por toast() para dismissSgToast(id) posterior."
+    ],
+    rankingSignals: {
+        freeText: 0.7,
+        structuredChoice: 0.5,
+        date: 0,
+        number: 0.2,
+        denseLayout: 0.3
+    }
+};

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

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

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

package/dist/commons/dismissSgWhistle.meta.js

@@ -0,0 +1,69 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.dismiss-whistle",
+    package: "@seedgrid/fe-components",
+    exportName: "dismissSgWhistle",
+    slug: "dismiss-sg-whistle",
+    displayName: "dismissSgWhistle",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para fechar/remover um whistle especifico ou todos os whistles. Complementa sgWhistle() para controle programatico.",
+    tags: ["hook", "whistle", "notification", "dismiss"],
+    capabilities: ["dismiss-specific", "dismiss-all", "programmatic-control"],
+    fieldSemantics: ["dismissal", "notificationControl", "cleanup"],
+    props: [
+        {
+            name: "id",
+            type: "SgWhistleId | undefined",
+            description: "ID do whistle a fechar. Se undefined, fecha todos os whistles.",
+            semanticRole: "data",
+            bindable: false
+        }
+    ],
+    states: ["dismissed", "all-dismissed"],
+    examples: [
+        {
+            id: "dismiss-one",
+            title: "Fechar um whistle especifico",
+            file: "apps/showcase/src/app/components/whistles/samples/dismiss-one.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "dismiss-all",
+            title: "Fechar todos os whistles",
+            file: "apps/showcase/src/app/components/whistles/samples/dismiss-all.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/whistles",
+        hasPlayground: true,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Fechar um whistle especifico quando o usuario clica em uma acao.",
+        "Limpar todos os whistles quando o usuario sai da pagina ou sessao.",
+        "Controlar o ciclo de vida de whistles programaticamente."
+    ],
+    avoidUseCases: [
+        "Fechar whistles cuja duracao ja expirou; o sistema faz isso automaticamente.",
+        "Usar sem ter disparado um whistle antes; valide o ID."
+    ],
+    synonyms: ["dismiss whistle", "close notification", "clear alert"],
+    relatedEntityFields: ["dismiss", "close", "cleanup"],
+    compositionHints: [
+        "Chamar apos uma acao do usuario.",
+        "Usar em cleanup de componentes para fechar whistles orphos.",
+        "Guardar o ID retornado por sgWhistle() para dismissSgWhistle(id) posterior."
+    ],
+    rankingSignals: {
+        freeText: 0.7,
+        structuredChoice: 0.5,
+        date: 0,
+        number: 0.2,
+        denseLayout: 0.3
+    }
+};

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

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

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

package/dist/commons/subscribeSgToasts.meta.js

@@ -0,0 +1,71 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.subscribe-toasts",
+    package: "@seedgrid/fe-components",
+    exportName: "subscribeSgToasts",
+    slug: "subscribe-sg-toasts",
+    displayName: "subscribeSgToasts",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para se inscrever em mudancas de toasts. Permite monitorar e reagir quando novos toasts sao criados ou removidos.",
+    tags: ["hook", "toast", "subscription", "reactive"],
+    capabilities: ["subscribe", "listen", "reactive-updates"],
+    fieldSemantics: ["subscription", "reactiveUpdates", "toastMonitoring"],
+    props: [
+        {
+            name: "listener",
+            type: "(toasts: SgToastRecord[]) => void",
+            required: true,
+            description: "Callback chamado quando toasts mudam. Recebe lista snapshot de toasts atual.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["subscribed", "unsubscribed"],
+    examples: [
+        {
+            id: "basic",
+            title: "Monitorar mudancas de toasts",
+            file: "apps/showcase/src/app/components/toasts/samples/subscribe.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "in-effect",
+            title: "Usar em useEffect",
+            file: "apps/showcase/src/app/components/toasts/samples/subscribe-effect.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/toasts",
+        hasPlayground: false,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Renderizar lista customizada de toasts.",
+        "Implementar analytics ou logging de notificacoes.",
+        "Sincronizar estado de toasts com componente nao-React.",
+        "Reagir quando um toast especifico aparece (ex: loading → success)."
+    ],
+    avoidUseCases: [
+        "Controlar exibicao de toasts; use SgToastHost para isso.",
+        "Modificar toasts dentro do listener; cria efeitos colaterais."
+    ],
+    synonyms: ["subscribe", "listen to toasts", "toast observer"],
+    relatedEntityFields: ["notification", "reactive", "subscription"],
+    compositionHints: [
+        "Usar em useEffect com cleanup para unsubscribe.",
+        "Guardar o unsubscribe retornado para limpeza.",
+        "Combinar com toast() e dismissSgToast() para controle completo."
+    ],
+    rankingSignals: {
+        freeText: 0.6,
+        structuredChoice: 0.5,
+        date: 0.3,
+        number: 0.2,
+        denseLayout: 0.4
+    }
+};

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

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

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

package/dist/commons/subscribeSgWhistles.meta.js

@@ -0,0 +1,71 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.subscribe-whistles",
+    package: "@seedgrid/fe-components",
+    exportName: "subscribeSgWhistles",
+    slug: "subscribe-sg-whistles",
+    displayName: "subscribeSgWhistles",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para se inscrever em mudancas de whistles. Permite monitorar e reagir quando novos whistles sao criados ou removidos.",
+    tags: ["hook", "whistle", "subscription", "reactive"],
+    capabilities: ["subscribe", "listen", "reactive-updates"],
+    fieldSemantics: ["subscription", "reactiveUpdates", "whistleMonitoring"],
+    props: [
+        {
+            name: "listener",
+            type: "(whistles: SgWhistleRecord[]) => void",
+            required: true,
+            description: "Callback chamado quando whistles mudam. Recebe lista snapshot de whistles atual.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["subscribed", "unsubscribed"],
+    examples: [
+        {
+            id: "basic",
+            title: "Monitorar mudancas de whistles",
+            file: "apps/showcase/src/app/components/whistles/samples/subscribe.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "in-effect",
+            title: "Usar em useEffect",
+            file: "apps/showcase/src/app/components/whistles/samples/subscribe-effect.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/whistles",
+        hasPlayground: false,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Renderizar lista customizada de whistles.",
+        "Implementar analytics ou logging de notificacoes.",
+        "Sincronizar estado de whistles com componente nao-React.",
+        "Reagir quando um whistle especifico aparece (ex: loading → success)."
+    ],
+    avoidUseCases: [
+        "Controlar exibicao de whistles; use SgWhistleHost para isso.",
+        "Modificar whistles dentro do listener; cria efeitos colaterais."
+    ],
+    synonyms: ["subscribe", "listen to whistles", "whistle observer"],
+    relatedEntityFields: ["notification", "reactive", "subscription"],
+    compositionHints: [
+        "Usar em useEffect com cleanup para unsubscribe.",
+        "Guardar o unsubscribe retornado para limpeza.",
+        "Combinar com sgWhistle() e dismissSgWhistle() para controle completo."
+    ],
+    rankingSignals: {
+        freeText: 0.7,
+        structuredChoice: 0.6,
+        date: 0.3,
+        number: 0.2,
+        denseLayout: 0.4
+    }
+};

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

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

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

package/dist/commons/toast.meta.js

@@ -0,0 +1,138 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.toast",
+    package: "@seedgrid/fe-components",
+    exportName: "toast",
+    slug: "toast",
+    displayName: "toast",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para disparar notificacoes toast. Oferece tipos predefinidos (success, error, warning, info, loading, default) com duracao customizavel, acoes e estilo.",
+    tags: ["hook", "toast", "notification", "alert"],
+    capabilities: ["type-support", "custom-styling", "actions", "promises", "dismiss"],
+    fieldSemantics: ["notification", "userFeedback", "statusMessage"],
+    props: [
+        {
+            name: "type",
+            type: "SgToastType",
+            required: true,
+            description: "Tipo de toast (success, error, warning, info, loading, default).",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "title",
+            type: "ReactNode",
+            required: true,
+            description: "Titulo ou mensagem principal do toast.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "options.id",
+            type: "string",
+            description: "ID unico para referenciar o toast.",
+            semanticRole: "data",
+            bindable: false
+        },
+        {
+            name: "options.description",
+            type: "ReactNode",
+            description: "Descricao ou mensagem secundaria.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "options.duration",
+            type: "number",
+            default: 3000,
+            description: "Duracao em milissegundos antes de auto-fechar (0 = permanente).",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "options.action",
+            type: "SgToastAction",
+            description: "Acao customizada (label e onClick).",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "options.closeButton",
+            type: "boolean",
+            default: true,
+            description: "Mostrar botao de fechar.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.className",
+            type: "string",
+            description: "Classe CSS customizada.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.style",
+            type: "CSSProperties",
+            description: "Estilos inline customizados.",
+            semanticRole: "appearance",
+            bindable: false
+        }
+    ],
+    states: ["success", "error", "warning", "info", "loading", "default"],
+    examples: [
+        {
+            id: "basic",
+            title: "Toast simples",
+            file: "apps/showcase/src/app/components/toasts/samples/basic.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "with-action",
+            title: "Toast com acao",
+            file: "apps/showcase/src/app/components/toasts/samples/with-action.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "promise",
+            title: "Toast com promise",
+            file: "apps/showcase/src/app/components/toasts/samples/promise.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/toasts",
+        hasPlayground: true,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Notificar sucesso de operacoes (save, delete, submit).",
+        "Comunicar erros e problemas ao usuario.",
+        "Exibir avisos e informacoes nao-bloqueantes.",
+        "Mostrar progresso de operacoes async com tipo 'loading'."
+    ],
+    avoidUseCases: [
+        "Dados que requerem confirmacao explícita; use SgDialog ou SgConfirmationDialog.",
+        "Mensagens persistentes que o usuario deve entender; use SgBanner ou SgAlert.",
+        "Feedback de validacao de formulario; use erros inline nos campos."
+    ],
+    synonyms: ["toast notification", "notification", "snackbar"],
+    relatedEntityFields: ["success", "error", "notification", "feedback"],
+    compositionHints: [
+        "Envolver a arvore com SgToastHost para exibir toasts.",
+        "Usar com try-catch para disparar toast de erro.",
+        "Combinar com promise para loading → success/error automático.",
+        "Usar subscribeSgToasts para monitorar toasts programaticamente."
+    ],
+    rankingSignals: {
+        freeText: 0.9,
+        structuredChoice: 0.6,
+        date: 0.3,
+        number: 0.3,
+        denseLayout: 0.5
+    }
+};

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

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

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

package/dist/commons/whistle.meta.js

@@ -0,0 +1,166 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "hook.whistle",
+    package: "@seedgrid/fe-components",
+    exportName: "sgWhistle",
+    slug: "sg-whistle",
+    displayName: "sgWhistle",
+    category: "hook",
+    subcategory: "notification",
+    description: "Funcao para disparar notificacoes whistle (banners/alertas). Oferece severidades, duracao customizavel, acoes, icones e estilos customizados.",
+    tags: ["hook", "whistle", "notification", "banner", "alert"],
+    capabilities: ["severity-support", "custom-styling", "actions", "promises", "dismiss"],
+    fieldSemantics: ["notification", "userAlert", "bannerMessage"],
+    props: [
+        {
+            name: "options.message",
+            type: "string",
+            required: true,
+            description: "Mensagem principal do whistle.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "options.severity",
+            type: "SgWhistleSeverity",
+            default: "default",
+            description: "Severidade (default, success, info, warning, error, loading).",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.title",
+            type: "string",
+            description: "Titulo opcional do whistle.",
+            semanticRole: "label",
+            bindable: true
+        },
+        {
+            name: "options.id",
+            type: "string",
+            description: "ID unico para referenciar o whistle.",
+            semanticRole: "data",
+            bindable: false
+        },
+        {
+            name: "options.icon",
+            type: "ReactNode",
+            description: "Icone customizado.",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "options.duration",
+            type: "number",
+            description: "Duracao em milissegundos (0 = permanente, padrao = permanente).",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "options.dismissible",
+            type: "boolean",
+            default: true,
+            description: "Permitir fechar manualmente.",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "options.borderStyle",
+            type: "SgWhistleBorderStyle",
+            default: "solid",
+            description: "Estilo da borda (solid, soft, left-accent, full-accent, none).",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.opacity",
+            type: "number",
+            description: "Opacidade (0-1).",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.action",
+            type: "SgWhistleAction",
+            description: "Acao customizada (label e onClick).",
+            semanticRole: "event",
+            bindable: false
+        },
+        {
+            name: "options.className",
+            type: "string",
+            description: "Classe CSS customizada.",
+            semanticRole: "appearance",
+            bindable: true
+        },
+        {
+            name: "options.style",
+            type: "CSSProperties",
+            description: "Estilos inline customizados.",
+            semanticRole: "appearance",
+            bindable: false
+        },
+        {
+            name: "options.onClose",
+            type: "() => void",
+            description: "Callback quando o whistle e fechado.",
+            semanticRole: "event",
+            bindable: false
+        }
+    ],
+    states: ["default", "success", "info", "warning", "error", "loading"],
+    examples: [
+        {
+            id: "basic",
+            title: "Whistle simples",
+            file: "apps/showcase/src/app/components/whistles/samples/basic.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "with-action",
+            title: "Whistle com acao",
+            file: "apps/showcase/src/app/components/whistles/samples/with-action.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "promise",
+            title: "Whistle com promise",
+            file: "apps/showcase/src/app/components/whistles/samples/promise.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/whistles",
+        hasPlayground: true,
+        hasPropsTable: true
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Alertas persistentes que o usuario precisa ver (warning, error).",
+        "Mensagens que ocupam espaco mas nao bloqueiam a interacao.",
+        "Status de operacoes async com duracao customizavel.",
+        "Feedback com multiplas acoes para o usuario."
+    ],
+    avoidUseCases: [
+        "Notificacoes rapidas que desaparecem automaticamente; use toast().",
+        "Informacoes que requerem confirmacao; use SgDialog.",
+        "Erros que bloqueiam a pagina; use tratamento de erro apropriado."
+    ],
+    synonyms: ["whistle", "banner", "alert", "notification banner"],
+    relatedEntityFields: ["alert", "warning", "notification", "status"],
+    compositionHints: [
+        "Envolver a arvore com SgWhistleHost para exibir whistles.",
+        "Usar com try-catch para disparar whistle de erro.",
+        "Combinar com promise para loading → success/error automático.",
+        "Usar subscribeSgWhistles para monitorar whistles programaticamente."
+    ],
+    rankingSignals: {
+        freeText: 0.85,
+        structuredChoice: 0.7,
+        date: 0.4,
+        number: 0.4,
+        denseLayout: 0.6
+    }
+};

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

package/dist/environment/useSgEnvironment.meta.d.ts.map

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