@seedgrid/fe-components 2026.4.11 → 2026.4.13

package/dist/gadgets/clock/SgTimeProvider.meta.js

@@ -0,0 +1,49 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "provider.time",
+    package: "@seedgrid/fe-components",
+    exportName: "SgTimeProvider",
+    slug: "sg-time-provider",
+    displayName: "SgTimeProvider",
+    category: "provider",
+    subcategory: "time",
+    description: "Provider de tempo sincronizado com o servidor, usado para clocks e gadgets temporais com atualizacao em tick controlado.",
+    tags: ["provider", "time", "clock", "server-sync", "context"],
+    capabilities: ["server-time-sync", "tick-context", "nowMs-provider", "hydration-aligned-updates"],
+    fieldSemantics: ["timeProvider", "serverSyncedTime", "clockContext"],
+    props: [
+        { name: "initialServerTime", type: "string", required: true, description: "Timestamp inicial do servidor em formato ISO 8601.", semanticRole: "value", bindable: true },
+        { name: "children", type: "ReactNode", required: true, description: "Arvore que vai consumir tempo sincronizado via useSgTime.", semanticRole: "data", bindable: false }
+    ],
+    states: ["default", "hydrating", "tick-updating", "fallback-without-provider"],
+    examples: [
+        { id: "basic", title: "Uso basico", file: "apps/showcase/src/app/components/providers/sg-time-provider/samples/uso-basico.tsx.sample", kind: "sample" },
+        { id: "nextjs", title: "Integracao com Next.js", file: "apps/showcase/src/app/components/providers/sg-time-provider/samples/integracao-com-nextjs.tsx.sample", kind: "sample" }
+    ],
+    showcase: { route: "/components/providers/sg-time-provider", hasPlayground: false, hasPropsTable: true },
+    sdui: {
+        rendererType: "provider.time",
+        acceptsDataBinding: true,
+        defaultProps: { initialServerTime: "1970-01-01T00:00:00.000Z" }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Sincronizar clocks e gadgets com o tempo do servidor em interfaces reativas.",
+        "Evitar drift entre SSR e cliente em exibicoes de tempo vivo.",
+        "Fornecer contexto temporal compartilhado para subtrees com relogios ou widgets sincronizados."
+    ],
+    avoidUseCases: [
+        "Selecao de data ou hora pelo usuario; nesses casos prefira inputs temporais.",
+        "Formatacao isolada de datas sem necessidade de contexto compartilhado.",
+        "Persistencia ou configuracao de ambiente sem relacao com tempo."
+    ],
+    synonyms: ["time provider", "server time context", "clock time provider", "synced time provider"],
+    relatedEntityFields: ["serverTime", "now", "tick", "currentTime", "clockContext"],
+    compositionHints: [
+        "Usar com SgClock e outros gadgets temporais que dependem de nowMs.",
+        "Combinar com SgClockThemeProvider em showcases ou dashboards de tempo."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0.88, number: 0, denseLayout: 0.66 }
+};

package/dist/gadgets/clock/themes/SgClockThemePicker.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=SgClockThemePicker.meta.d.ts.map

package/dist/gadgets/clock/themes/SgClockThemePicker.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgClockThemePicker.meta.d.ts","sourceRoot":"","sources":["../../../../src/gadgets/clock/themes/SgClockThemePicker.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,MAAM,EAAE,QAoCpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/gadgets/clock/themes/SgClockThemePicker.meta.js

@@ -0,0 +1,56 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.clock-theme-picker",
+    package: "@seedgrid/fe-components",
+    exportName: "SgClockThemePicker",
+    slug: "sg-clock-theme-picker",
+    displayName: "SgClockThemePicker",
+    category: "gadget",
+    subcategory: "theme-picker",
+    description: "Seletor visual de temas de relogio com preview embutido, filtro de temas e integracao com o resolver de temas do clock.",
+    tags: ["gadget", "clock", "theme", "picker", "selection"],
+    capabilities: ["theme-selection", "preview-rendering", "searchable-themes", "resolver-aware"],
+    fieldSemantics: ["themeSelection", "clockThemePicker", "visualThemeChoice"],
+    props: [
+        { name: "value", type: "string", required: true, description: "ID do tema atualmente selecionado.", semanticRole: "value", bindable: true },
+        { name: "onChange", type: "(id: string) => void", required: true, description: "Callback disparado quando um novo tema e escolhido.", semanticRole: "event", bindable: false },
+        { name: "label", type: "string", description: "Rotulo opcional exibido acima do seletor.", semanticRole: "label", bindable: true },
+        { name: "placeholder", type: "string", description: "Texto exibido quando nenhum tema valido esta resolvido.", semanticRole: "label", bindable: true },
+        { name: "filter", type: "(theme: SgClockTheme) => boolean", description: "Filtro adicional sobre a lista de temas disponiveis.", semanticRole: "behavior", bindable: false },
+        { name: "previewSize", type: "number", default: 56, description: "Tamanho do preview visual de cada tema.", semanticRole: "appearance", bindable: true },
+        { name: "searchable", type: "boolean", default: true, description: "Ativa busca textual na lista de temas.", semanticRole: "behavior", bindable: true },
+        { name: "fallbackThemeId", type: "string", default: "classic", description: "Tema usado quando o valor atual nao pode ser resolvido.", semanticRole: "behavior", bindable: true },
+        { name: "defaultOpen", type: "boolean", default: false, description: "Abre a lista inicialmente no primeiro render.", semanticRole: "behavior", bindable: true }
+    ],
+    states: ["default", "open", "searching", "theme-selected"],
+    examples: [
+        { id: "provider-basic", title: "Uso com provider", file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/uso-basico.tsx.sample", kind: "sample" },
+        { id: "theme-local", title: "Tema local customizado", file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/tema-local-customizado.tsx.sample", kind: "sample" }
+    ],
+    showcase: { route: "/components/gadgets/sg-clock-theme-picker", hasPlayground: false, hasPropsTable: true },
+    sdui: {
+        rendererType: "gadget.clock-theme-picker",
+        acceptsDataBinding: true,
+        defaultProps: { searchable: true, previewSize: 56, fallbackThemeId: "classic", defaultOpen: false }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Permitir que o usuario escolha o tema visual de um relogio ou widget temporal.",
+        "Explorar galerias de temas de clock com preview rapido e filtro textual.",
+        "Compor configuracoes visuais em dashboards ou paines de personalizacao."
+    ],
+    avoidUseCases: [
+        "Selecao generica de opcoes estruturadas sem semantica de tema visual; nesses casos prefira Combobox ou RadioGroup.",
+        "Preview estatico sem interacao; nesses casos prefira SgClockThemePreview.",
+        "Aplicar tema global de toda a app; nesses casos prefira providers de tema dedicados."
+    ],
+    synonyms: ["clock theme picker", "theme selector", "theme chooser", "visual theme picker"],
+    relatedEntityFields: ["themeId", "clockTheme", "selectedTheme", "appearanceTheme"],
+    compositionHints: [
+        "Usar junto de SgClockThemeProvider para resolver temas locais e fallback.",
+        "Combinar com SgClock e SgClockThemePreview em paineis de personalizacao."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0.86, date: 0.12, number: 0, denseLayout: 0.64 }
+};

package/dist/gadgets/clock/themes/SgClockThemePreview.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=SgClockThemePreview.meta.d.ts.map

package/dist/gadgets/clock/themes/SgClockThemePreview.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgClockThemePreview.meta.d.ts","sourceRoot":"","sources":["../../../../src/gadgets/clock/themes/SgClockThemePreview.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,MAAM,EAAE,QA8BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/gadgets/clock/themes/SgClockThemePreview.meta.js

@@ -0,0 +1,50 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.clock-theme-preview",
+    package: "@seedgrid/fe-components",
+    exportName: "SgClockThemePreview",
+    slug: "sg-clock-theme-preview",
+    displayName: "SgClockThemePreview",
+    category: "gadget",
+    subcategory: "theme-preview",
+    description: "Preview visual compacto de um tema de relogio, renderizado em SVG para comparacao rapida de estilos.",
+    tags: ["gadget", "clock", "theme", "preview", "svg"],
+    capabilities: ["theme-preview", "svg-rendering", "compact-visualization", "dark-flag-aware"],
+    fieldSemantics: ["themePreview", "clockThemePreview", "visualStylePreview"],
+    props: [
+        { name: "theme", type: "SgClockTheme", required: true, description: "Tema visual usado na renderizacao do preview.", semanticRole: "value", bindable: true },
+        { name: "size", type: "number", default: 64, description: "Dimensao do preview quadrado em pixels.", semanticRole: "appearance", bindable: true },
+        { name: "className", type: "string", description: "Classes adicionais aplicadas ao SVG raiz.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["default", "dark-aware"],
+    examples: [
+        { id: "provider-basic", title: "Uso com picker", file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/uso-basico.tsx.sample", kind: "sample" },
+        { id: "inline-theme", title: "Tema inline no clock", file: "apps/showcase/src/app/components/gadgets/sg-clock/samples/tema-inline-sem-provider.tsx.sample", kind: "sample" }
+    ],
+    showcase: { route: "/components/gadgets/sg-clock-theme-preview", hasPlayground: false, hasPropsTable: true },
+    sdui: {
+        rendererType: "gadget.clock-theme-preview",
+        acceptsDataBinding: true,
+        defaultProps: { size: 64 }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Comparar visualmente temas de relogio em galerias e seletores.",
+        "Renderizar miniaturas de estilos antes da aplicacao efetiva do tema.",
+        "Exibir previews compactos em listas de configuracao visual."
+    ],
+    avoidUseCases: [
+        "Selecao direta de tema; nesses casos prefira SgClockThemePicker.",
+        "Renderizacao do relogio funcional completo; nesses casos prefira SgClock.",
+        "Indicadores numericos ou gauges sem relacao com temas de clock."
+    ],
+    synonyms: ["clock theme preview", "theme thumbnail", "theme preview", "style preview"],
+    relatedEntityFields: ["theme", "themePreview", "themeThumbnail", "clockTheme"],
+    compositionHints: [
+        "Usar dentro de SgClockThemePicker para listas de selecao visual.",
+        "Combinar com SgClockThemeProvider e SgClock em fluxos de configuracao."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0.34, date: 0.08, number: 0, denseLayout: 0.58 }
+};

package/dist/gadgets/clock/themes/SgClockThemeProvider.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=SgClockThemeProvider.meta.d.ts.map

package/dist/gadgets/clock/themes/SgClockThemeProvider.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SgClockThemeProvider.meta.d.ts","sourceRoot":"","sources":["../../../../src/gadgets/clock/themes/SgClockThemeProvider.meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEpE,eAAO,MAAM,MAAM,EAAE,QA+BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAmBrB,CAAC"}

package/dist/gadgets/clock/themes/SgClockThemeProvider.meta.js

@@ -0,0 +1,51 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "provider.clock-theme",
+    package: "@seedgrid/fe-components",
+    exportName: "SgClockThemeProvider",
+    slug: "sg-clock-theme-provider",
+    displayName: "SgClockThemeProvider",
+    category: "provider",
+    subcategory: "theme",
+    description: "Provider de resolucao de temas de relogio, com suporte a fallback, temas locais e integracao com o registro global.",
+    tags: ["provider", "clock", "theme", "resolver", "context"],
+    capabilities: ["theme-context", "fallback-resolution", "local-themes", "global-theme-merge"],
+    fieldSemantics: ["themeProvider", "clockThemeResolution", "themeRegistryScope"],
+    props: [
+        { name: "value.mode", type: '"fallback" | "strict"', default: "fallback", description: "Modo de resolucao para temas ausentes.", semanticRole: "behavior", bindable: true },
+        { name: "value.fallbackThemeId", type: "string", default: "classic", description: "Tema padrao usado em modo fallback.", semanticRole: "behavior", bindable: true },
+        { name: "value.themes", type: "SgClockTheme[]", default: [], description: "Lista de temas locais adicionados apenas neste escopo.", semanticRole: "data", bindable: true },
+        { name: "children", type: "ReactNode", required: true, description: "Arvore que vai consumir o resolver de temas.", semanticRole: "data", bindable: false }
+    ],
+    states: ["default", "fallback-mode", "strict-mode", "local-themes-loaded"],
+    examples: [
+        { id: "basic", title: "Uso basico", file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/uso-basico.tsx.sample", kind: "sample" },
+        { id: "global-register", title: "Registro global", file: "apps/showcase/src/app/components/providers/sg-clock-theme-provider/samples/registro-global.tsx.sample", kind: "sample" }
+    ],
+    showcase: { route: "/components/providers/sg-clock-theme-provider", hasPlayground: false, hasPropsTable: true },
+    sdui: {
+        rendererType: "provider.clock-theme",
+        acceptsDataBinding: true,
+        defaultProps: { value: { mode: "fallback", fallbackThemeId: "classic", themes: [] } }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Escopar resolucao de temas de clock para uma subtree especifica.",
+        "Fornecer fallback consistente e temas locais para widgets de relogio.",
+        "Compor paines de personalizacao com registro global e override local."
+    ],
+    avoidUseCases: [
+        "Selecao visual de tema pelo usuario; nesses casos prefira SgClockThemePicker.",
+        "Renderizacao direta do relogio; nesses casos prefira SgClock.",
+        "Tema global generico da aplicacao fora do dominio de clock."
+    ],
+    synonyms: ["clock theme provider", "theme resolver provider", "clock theme context"],
+    relatedEntityFields: ["themeResolver", "clockThemeScope", "fallbackThemeId", "localThemes"],
+    compositionHints: [
+        "Usar com SgClock e SgClockThemePicker no mesmo subtree.",
+        "Combinar com registerTheme e registerThemes quando houver catalogo compartilhado."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0.18, number: 0, denseLayout: 0.72 }
+};

package/dist/gadgets/gauge/SgLinearGauge.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=SgLinearGauge.meta.d.ts.map

package/dist/gadgets/gauge/SgLinearGauge.meta.d.ts.map

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

package/dist/gadgets/gauge/SgLinearGauge.meta.js

@@ -0,0 +1,57 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.linear-gauge",
+    package: "@seedgrid/fe-components",
+    exportName: "SgLinearGauge",
+    slug: "sg-linear-gauge",
+    displayName: "SgLinearGauge",
+    category: "gadget",
+    subcategory: "linear-gauge",
+    description: "Gauge linear para exibicao de medicao, faixas de valor, ponteiros adicionais e ajuste arrastavel em eixos horizontal ou vertical.",
+    tags: ["gadget", "gauge", "linear", "meter", "measurement"],
+    capabilities: ["linear-meter", "range-highlights", "draggable-pointers", "horizontal-vertical", "tick-label-control"],
+    fieldSemantics: ["linearGauge", "measurementDisplay", "rangeIndicator", "meter"],
+    props: [
+        { name: "min", type: "number", default: 0, description: "Valor minimo da escala.", semanticRole: "validation", bindable: true },
+        { name: "max", type: "number", default: 100, description: "Valor maximo da escala.", semanticRole: "validation", bindable: true },
+        { name: "value", type: "number", description: "Valor do ponteiro principal.", semanticRole: "value", bindable: true },
+        { name: "onValueChange", type: "(value: number) => void", description: "Callback do ponteiro principal.", semanticRole: "event", bindable: false },
+        { name: "pointers", type: "SgLinearGaugePointer[]", default: [], description: "Ponteiros adicionais renderizados sobre o eixo.", semanticRole: "data", bindable: true },
+        { name: "ranges", type: "SgLinearGaugeRange[]", default: [], description: "Faixas coloridas aplicadas sobre a escala.", semanticRole: "data", bindable: true },
+        { name: "orientation", type: '"horizontal" | "vertical"', default: "horizontal", description: "Orientacao do gauge.", semanticRole: "appearance", bindable: true },
+        { name: "showLabels", type: "boolean", default: true, description: "Exibe rotulos da escala.", semanticRole: "appearance", bindable: true },
+        { name: "showTicks", type: "boolean", default: true, description: "Exibe ticks da escala.", semanticRole: "appearance", bindable: true },
+        { name: "primaryPointerDraggable", type: "boolean", default: false, description: "Permite arrastar o ponteiro principal.", semanticRole: "behavior", bindable: true }
+    ],
+    states: ["default", "with-ranges", "with-pointers", "dragging"],
+    examples: [
+        { id: "default-horizontal", title: "Horizontal", file: "apps/showcase/src/app/components/gadgets/sg-linear-gauge/samples/default-horizontal.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/gadgets/sg-linear-gauge/sg-linear-gauge.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/gadgets/sg-linear-gauge", hasPlayground: true, hasPropsTable: true },
+    sdui: {
+        rendererType: "gadget.linear-gauge",
+        acceptsDataBinding: true,
+        defaultProps: { min: 0, max: 100, orientation: "horizontal", showLabels: true, showTicks: true, primaryPointerDraggable: false }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir medicao continua em eixo linear com faixas de referencia.",
+        "Representar progresso, temperatura, estoque ou nivel em dashboards operacionais.",
+        "Permitir ajuste arrastavel quando o gauge tambem atua como controle visual."
+    ],
+    avoidUseCases: [
+        "Entrada numerica textual simples; nesses casos prefira SgInputNumber.",
+        "Comparacao tabular de muitos registros; nesses casos prefira Datatable.",
+        "Visual circular ou speedometer; nesses casos prefira SgRadialGauge."
+    ],
+    synonyms: ["linear gauge", "linear meter", "level indicator", "measurement bar"],
+    relatedEntityFields: ["value", "progress", "temperature", "level", "measurement"],
+    compositionHints: [
+        "Usar com Card, Dashboard e paines operacionais para indicadores de status.",
+        "Combinar com Button ou sliders auxiliares em demos interativas."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0.72, denseLayout: 0.8 }
+};

package/dist/gadgets/gauge/SgRadialGauge.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=SgRadialGauge.meta.d.ts.map

package/dist/gadgets/gauge/SgRadialGauge.meta.d.ts.map

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

package/dist/gadgets/gauge/SgRadialGauge.meta.js

@@ -0,0 +1,57 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.radial-gauge",
+    package: "@seedgrid/fe-components",
+    exportName: "SgRadialGauge",
+    slug: "sg-radial-gauge",
+    displayName: "SgRadialGauge",
+    category: "gadget",
+    subcategory: "radial-gauge",
+    description: "Gauge radial com ponteiros, faixas, anotacoes e controle de angulos para cenarios de speedometer, dial e medicao circular.",
+    tags: ["gadget", "gauge", "radial", "dial", "speedometer"],
+    capabilities: ["radial-meter", "needle-marker-range-pointers", "annotations", "arc-configuration", "drag-support"],
+    fieldSemantics: ["radialGauge", "speedometer", "dialMeter", "circularMeasurement"],
+    props: [
+        { name: "min", type: "number", default: 0, description: "Valor minimo da escala.", semanticRole: "validation", bindable: true },
+        { name: "max", type: "number", default: 100, description: "Valor maximo da escala.", semanticRole: "validation", bindable: true },
+        { name: "value", type: "number", description: "Valor do ponteiro principal.", semanticRole: "value", bindable: true },
+        { name: "onValueChange", type: "(value: number) => void", description: "Callback do ponteiro principal.", semanticRole: "event", bindable: false },
+        { name: "pointers", type: "SgRadialGaugePointer[]", default: [], description: "Ponteiros adicionais do tipo needle, marker ou range.", semanticRole: "data", bindable: true },
+        { name: "ranges", type: "SgRadialGaugeRange[]", default: [], description: "Faixas coloridas sobre o arco principal.", semanticRole: "data", bindable: true },
+        { name: "annotations", type: "SgRadialGaugeAnnotation[]", default: [], description: "Anotacoes posicionadas por valor ou angulo.", semanticRole: "data", bindable: true },
+        { name: "startAngle", type: "number", default: 135, description: "Angulo inicial do arco.", semanticRole: "appearance", bindable: true },
+        { name: "endAngle", type: "number", default: 45, description: "Angulo final do arco.", semanticRole: "appearance", bindable: true },
+        { name: "primaryPointerType", type: '"needle" | "marker" | "range"', default: "needle", description: "Tipo visual do ponteiro principal.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["default", "with-ranges", "with-annotations", "dragging"],
+    examples: [
+        { id: "speedometer", title: "Speedometer", file: "apps/showcase/src/app/components/gadgets/sg-radial-gauge/samples/speedometer-style.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/gadgets/sg-radial-gauge/sg-radial-gauge.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/gadgets/sg-radial-gauge", hasPlayground: true, hasPropsTable: true },
+    sdui: {
+        rendererType: "gadget.radial-gauge",
+        acceptsDataBinding: true,
+        defaultProps: { min: 0, max: 100, startAngle: 135, endAngle: 45, primaryPointerType: "needle" }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Representar medicao circular em speedometers, paines de telemetria e dashboards.",
+        "Exibir indicadores de performance com foco em dial, arco e ponteiros visuais.",
+        "Combinar anotacoes e faixas de alerta em instrumentos circulares."
+    ],
+    avoidUseCases: [
+        "Indicadores lineares simples; nesses casos prefira SgLinearGauge.",
+        "Entrada numerica direta por teclado; nesses casos prefira SgInputNumber.",
+        "Graficos analiticos com series temporais; nesses casos prefira charting dedicado."
+    ],
+    synonyms: ["radial gauge", "speedometer", "dial gauge", "circular meter"],
+    relatedEntityFields: ["value", "rpm", "speed", "score", "efficiency"],
+    compositionHints: [
+        "Usar com Card, Screen e dashboards para indicadores de alto impacto visual.",
+        "Combinar com annotations e centerContent para KPIs operacionais."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0.74, denseLayout: 0.82 }
+};

package/dist/gadgets/qr-code/SgQRCode.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=SgQRCode.meta.d.ts.map

package/dist/gadgets/qr-code/SgQRCode.meta.d.ts.map

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

@@ -0,0 +1,48 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.qr-code",
+    package: "@seedgrid/fe-components",
+    exportName: "SgQRCode",
+    slug: "sg-qr-code",
+    displayName: "SgQRCode",
+    category: "gadget",
+    subcategory: "qr-code",
+    description: "Gerador visual de QR Code com configuracao de valor, logo central, tamanho, margem e cores.",
+    tags: ["gadget", "qr-code", "barcode", "pix", "share"],
+    capabilities: ["qr-generation", "logo-overlay", "size-control", "color-customization", "empty-fallback"],
+    fieldSemantics: ["qrCode", "shareCode", "pixCode", "encodedLink", "machineReadableCode"],
+    props: [
+        { name: "value", type: "string", required: true, description: "Valor textual codificado no QR Code.", semanticRole: "value", bindable: true },
+        { name: "size", type: "number", default: 220, description: "Tamanho do QR em pixels.", semanticRole: "appearance", bindable: true },
+        { name: "logoSrc", type: "string", description: "URL da logo exibida no centro do QR.", semanticRole: "appearance", bindable: true },
+        { name: "fgColor", type: "string", default: "#000000", description: "Cor principal do QR Code.", semanticRole: "appearance", bindable: true },
+        { name: "bgColor", type: "string", default: "#FFFFFF", description: "Cor de fundo do QR Code.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["idle", "empty", "rendered"],
+    examples: [
+        { id: "interactive", title: "Interativo", file: "apps/showcase/src/app/components/gadgets/sg-qr-code/samples/interativo.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/gadgets/sg-qr-code/sg-qr-code.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/gadgets/sg-qr-code", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "gadget.qr-code", acceptsDataBinding: true, defaultProps: { size: 220, fgColor: "#000000", bgColor: "#FFFFFF" } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Exibir links, payloads PIX e codigos escaneaveis em telas e comprovantes.",
+        "Compartilhar acesso rapido a URLs, apps e recursos externos.",
+        "Representar codigos maquina-legiveis em cards, dialogos e comprovantes."
+    ],
+    avoidUseCases: [
+        "Entrada de texto ou edicao de dados.",
+        "Valores numericos simples sem necessidade de codificacao visual.",
+        "Blocos de conteudo textual longo."
+    ],
+    synonyms: ["qr code", "code generator", "pix qr", "scan code"],
+    relatedEntityFields: ["qrCode", "pixPayload", "shareUrl", "encodedValue", "paymentCode"],
+    compositionHints: [
+        "Usar com SgCard, SgDialog e SgPanel para areas de compartilhamento ou pagamento.",
+        "Combinar com SgBadge e SgButton para acoes de copiar e compartilhar."
+    ],
+    rankingSignals: { freeText: 0.08, structuredChoice: 0, date: 0, number: 0.1, denseLayout: 0.42 }
+};

package/dist/gadgets/string-animator/SgStringAnimator.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=SgStringAnimator.meta.d.ts.map

package/dist/gadgets/string-animator/SgStringAnimator.meta.d.ts.map

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

@@ -0,0 +1,48 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "gadget.string-animator",
+    package: "@seedgrid/fe-components",
+    exportName: "SgStringAnimator",
+    slug: "sg-string-animator",
+    displayName: "SgStringAnimator",
+    category: "gadget",
+    subcategory: "text-animation",
+    description: "Componente para animar transicao entre strings usando estilos como roller3d, flip e neon em displays textuais curtos.",
+    tags: ["gadget", "string", "animation", "display", "text"],
+    capabilities: ["string-transition", "multiple-animation-styles", "manual-trigger", "alignment-control"],
+    fieldSemantics: ["animatedText", "labelTransition", "displayText", "headlineAnimator"],
+    props: [
+        { name: "sourceString", type: "string", required: true, description: "Texto inicial da animacao.", semanticRole: "value", bindable: true },
+        { name: "targetString", type: "string", required: true, description: "Texto final da animacao.", semanticRole: "value", bindable: true },
+        { name: "stringAnimatorStyle", type: '"roller3d" | "flip" | "neon" | "fade" | "matrix" | "discard" | "segment" | "sevenSegment"', default: "roller3d", description: "Estilo visual usado na transicao.", semanticRole: "appearance", bindable: true },
+        { name: "alignTo", type: '"left" | "center" | "right"', default: "left", description: "Alinhamento do texto animado.", semanticRole: "appearance", bindable: true },
+        { name: "fontSize", type: "number", default: 28, description: "Escala visual do display.", semanticRole: "appearance", bindable: true }
+    ],
+    states: ["idle", "animating", "completed"],
+    examples: [
+        { id: "roller3d", title: "Roller 3D", file: "apps/showcase/src/app/components/gadgets/sg-string-animator/samples/roller3d.tsx.sample", kind: "sample" },
+        { id: "playground", title: "Playground", file: "apps/showcase/src/app/components/gadgets/sg-string-animator/sg-string-animator.tsx.playground", kind: "playground" }
+    ],
+    showcase: { route: "/components/gadgets/sg-string-animator", hasPlayground: true, hasPropsTable: true },
+    sdui: { rendererType: "gadget.string-animator", acceptsDataBinding: true, defaultProps: { stringAnimatorStyle: "roller3d", alignTo: "left", fontSize: 28 } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Animar mudanca de labels, titulos curtos e textos de destaque.",
+        "Criar widgets textuais com transicao visual em dashboards e landing sections.",
+        "Representar evolucao entre dois estados textuais curtos."
+    ],
+    avoidUseCases: [
+        "Paragrafos longos ou conteudo de leitura extensa.",
+        "Campos editaveis de formulario.",
+        "Tabelas e listas com alto volume de linhas."
+    ],
+    synonyms: ["string animator", "animated text", "text transition", "display animator"],
+    relatedEntityFields: ["title", "statusLabel", "headline", "label", "displayText"],
+    compositionHints: [
+        "Usar com SgCard e SgDashboard em secoes de destaque.",
+        "Combinar com digitos animados para paineis hibridos de texto e numero."
+    ],
+    rankingSignals: { freeText: 0.38, structuredChoice: 0, date: 0, number: 0.12, denseLayout: 0.28 }
+};

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

package/dist/i18n/SgComponentsI18nProvider.meta.d.ts.map

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

package/dist/i18n/SgComponentsI18nProvider.meta.js

@@ -0,0 +1,50 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "provider.components-i18n",
+    package: "@seedgrid/fe-components",
+    exportName: "SgComponentsI18nProvider",
+    slug: "sg-components-i18n-provider",
+    displayName: "SgComponentsI18nProvider",
+    category: "provider",
+    subcategory: "i18n",
+    description: "Provider de internacionalizacao para os componentes SeedGrid, com locale, mensagens embutidas e sobrescrita pontual por subtree.",
+    tags: ["provider", "i18n", "locale", "messages", "context"],
+    capabilities: ["locale-scoping", "message-overrides", "built-in-locales", "runtime-i18n-context"],
+    fieldSemantics: ["i18nProvider", "localeScope", "messageOverrides"],
+    props: [
+        { name: "locale", type: "SgComponentsLocale", default: "en-US", description: "Locale aplicado aos componentes dentro do provider.", semanticRole: "behavior", bindable: true },
+        { name: "messages", type: "SgComponentsMessages | SgComponentsMessagesByNamespace", description: "Mapa de mensagens customizadas ou sobrescritas.", semanticRole: "data", bindable: true },
+        { name: "children", type: "ReactNode", required: true, description: "Arvore de componentes que consome o contexto de i18n.", semanticRole: "data", bindable: false }
+    ],
+    states: ["default", "locale-bound", "message-overridden"],
+    examples: [
+        { id: "basic", title: "Uso basico", file: "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/uso-basico.tsx.sample", kind: "sample" },
+        { id: "dynamic", title: "Troca dinamica de locale", file: "apps/showcase/src/app/components/providers/sg-components-i18n-provider/samples/troca-dinamica-de-locale.tsx.sample", kind: "sample" }
+    ],
+    showcase: { route: "/components/providers/sg-components-i18n-provider", hasPlayground: false, hasPropsTable: true },
+    sdui: {
+        rendererType: "provider.components-i18n",
+        acceptsDataBinding: true,
+        defaultProps: { locale: "en-US", messages: {} }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Trocar locale e mensagens internas dos componentes em um subtree controlado.",
+        "Sobrescrever textos padrao sem alterar a implementacao dos componentes.",
+        "Compor demos, shells ou modulos com locale diferente do restante da aplicacao."
+    ],
+    avoidUseCases: [
+        "Traducao de conteudo de negocio externo aos componentes SeedGrid.",
+        "Selecao visual de idioma pelo usuario sem provider; nesses casos use UI propria combinada com este provider.",
+        "Persistencia de preferencias do usuario; nesses casos combine com ambiente ou storage."
+    ],
+    synonyms: ["components i18n provider", "locale provider", "messages provider", "translation context"],
+    relatedEntityFields: ["locale", "messages", "translations", "i18nConfig"],
+    compositionHints: [
+        "Usar com hooks como useComponentsI18n e com componentes que exibem mensagens internas.",
+        "Combinar com SgEnvironmentProvider quando locale e preferencias precisarem de persistencia."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0, denseLayout: 0.68 }
+};

package/dist/index.d.ts

@@ -2,12 +2,10 @@ export { SgInputText } from "./inputs/SgInputText";
 export type { SgInputTextProps } from "./inputs/SgInputText";
 export { SgInputNumber } from "./inputs/SgInputNumber";
 export type { SgInputNumberProps } from "./inputs/SgInputNumber";
-export { SgInputCurrency, SgCurrencyEdit } from "./inputs/SgInputCurrency";
-export type { SgInputCurrencyProps, SgCurrencyEditProps } from "./inputs/SgInputCurrency";
+export { SgInputCurrency } from "./inputs/SgInputCurrency";
+export type { SgInputCurrencyProps } from "./inputs/SgInputCurrency";
 export { SgInputTextArea } from "./inputs/SgInputTextArea";
 export type { SgInputTextAreaProps } from "./inputs/SgInputTextArea";
-export { SgInputSelect } from "./inputs/SgInputSelect";
-export type { SgInputSelectProps } from "./inputs/SgInputSelect";
 export { SgInputCPF } from "./inputs/SgInputCPF";
 export type { SgInputCPFProps } from "./inputs/SgInputCPF";
 export { SgInputCNPJ } from "./inputs/SgInputCNPJ";
@@ -28,8 +26,8 @@ export { SgStepperInput } from "./inputs/SgStepperInput";
 export type { SgStepperInputProps } from "./inputs/SgStepperInput";
 export { SgInputDate } from "./inputs/SgInputDate";
 export { SgInputBirthDate } from "./inputs/SgInputBirthDate";
-export { SgToggleSwitch, SgSwitch } from "./inputs/SgToggleSwitch";
-export type { SgToggleSwitchProps, SgSwitchProps } from "./inputs/SgToggleSwitch";
+export { SgToggleSwitch } from "./inputs/SgToggleSwitch";
+export type { SgToggleSwitchProps } from "./inputs/SgToggleSwitch";
 export { SgAutocomplete } from "./inputs/SgAutocomplete";
 export type { SgAutocompleteItem, SgAutocompleteProps } from "./inputs/SgAutocomplete";
 export { SgCombobox } from "./inputs/SgCombobox";