@seedgrid/fe-theme 2026.4.18 → 2026.4.20

package/dist/theme/SeedThemeProvider.meta.d.ts

@@ -0,0 +1,61 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaExampleV0 = {
+    id: string;
+    title: string;
+    file: string;
+    kind: "sample" | "playground";
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    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>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=SeedThemeProvider.meta.d.ts.map

package/dist/theme/SeedThemeProvider.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeedThemeProvider.meta.d.ts","sourceRoot":"","sources":["../../src/theme/SeedThemeProvider.meta.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,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,KAAK,eAAe,GAAG;IACrB,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,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,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,KAAK,WAAW,GAAG;IACjB,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;AAEF,eAAO,MAAM,MAAM,EAAE,QA8EpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WA0BrB,CAAC"}

package/dist/theme/SeedThemeProvider.meta.js

@@ -0,0 +1,105 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "provider.seed-theme",
+    package: "@seedgrid/fe-theme",
+    exportName: "SeedThemeProvider",
+    slug: "seed-theme-provider",
+    displayName: "SeedThemeProvider",
+    category: "provider",
+    subcategory: "theme",
+    description: "Provider de tema SeedGrid com suporte a modo claro/escuro, persistencia, deteccao de modo do sistema e customizacao de cores e raio de borda.",
+    tags: ["provider", "theme", "dark-mode", "persistence", "design-tokens"],
+    capabilities: ["light-dark-mode", "auto-detect-system", "theme-persistence", "css-variables", "dynamic-theming"],
+    fieldSemantics: ["themeProvider", "designTokens", "colorScheme"],
+    props: [
+        {
+            name: "initialTheme",
+            type: "SeedThemeInput",
+            description: "Configuracao inicial do tema (seed, mode, radius, persistenceStrategy, persistMode).",
+            semanticRole: "data",
+            bindable: true
+        },
+        {
+            name: "applyTo",
+            type: '"html" | "wrapper"',
+            default: "html",
+            description: "Onde aplicar as variaveis CSS (html ou div wrapper).",
+            semanticRole: "behavior",
+            bindable: true
+        },
+        {
+            name: "children",
+            type: "ReactNode",
+            required: true,
+            description: "Arvore de componentes que consome o contexto de tema.",
+            semanticRole: "data",
+            bindable: false
+        }
+    ],
+    states: ["light", "dark", "auto"],
+    examples: [
+        {
+            id: "basic",
+            title: "Tema basico com modo claro",
+            file: "apps/showcase/src/app/components/providers/seed-theme-provider/samples/basic.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "dark-mode",
+            title: "Com modo escuro customizado",
+            file: "apps/showcase/src/app/components/providers/seed-theme-provider/samples/dark-mode.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "auto-detect",
+            title: "Auto-deteccao do modo do sistema",
+            file: "apps/showcase/src/app/components/providers/seed-theme-provider/samples/auto-detect.tsx.sample",
+            kind: "sample"
+        },
+        {
+            id: "theme-switcher",
+            title: "Seletor dinamico de tema",
+            file: "apps/showcase/src/app/components/providers/seed-theme-provider/samples/theme-switcher.tsx.sample",
+            kind: "sample"
+        }
+    ],
+    showcase: {
+        route: "/components/providers/seed-theme-provider",
+        hasPlayground: true,
+        hasPropsTable: true
+    },
+    sdui: {
+        rendererType: "provider.seed-theme",
+        acceptsDataBinding: true,
+        defaultProps: {
+            applyTo: "html"
+        }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Aplicar tema SeedGrid a toda a aplicacao com variaveis CSS.",
+        "Suportar modo claro/escuro com persistencia de preferencia.",
+        "Auto-detectar preferencia do usuario a partir do sistema operacional.",
+        "Customizar cores e raio de borda dinamicamente."
+    ],
+    avoidUseCases: [
+        "Apenas trocar cores de componentes individuais; use CSS direto.",
+        "Tema nao-SeedGrid; considere solucoes de terceiros (next-themes, etc)."
+    ],
+    synonyms: ["theme provider", "seed theme", "design token provider"],
+    relatedEntityFields: ["theme", "mode", "colors", "darkMode"],
+    compositionHints: [
+        "Posicionar no topo da arvore React para afetar todos os componentes.",
+        "Combinar com useSgTheme() para acessar contexto e alterar tema.",
+        "Usar com SgEnvironmentProvider para persistencia coordenada."
+    ],
+    rankingSignals: {
+        freeText: 0.7,
+        structuredChoice: 0.9,
+        date: 0,
+        number: 0.3,
+        denseLayout: 0.8
+    }
+};

package/dist/theme/ThemeProvider.meta.d.ts

@@ -0,0 +1,60 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    subcategory?: string;
+    description: string;
+    tags?: string[];
+    capabilities?: string[];
+    fieldSemantics?: string[];
+    props?: SgMetaPropV0[];
+    states?: string[];
+    examples?: Array<{
+        id: string;
+        title: string;
+        file: string;
+        kind: "sample" | "playground";
+    }>;
+    showcase?: {
+        route: string;
+        hasPlayground: boolean;
+        hasPropsTable: boolean;
+    };
+    sdui?: {
+        rendererType: string;
+        acceptsDataBinding?: boolean;
+        defaultProps?: Record<string, unknown>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=ThemeProvider.meta.d.ts.map

package/dist/theme/ThemeProvider.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.meta.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.meta.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,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,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,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,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,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,KAAK,WAAW,GAAG;IACjB,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;AAEF,eAAO,MAAM,MAAM,EAAE,QA0BpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAkBrB,CAAC"}

package/dist/theme/ThemeProvider.meta.js

@@ -0,0 +1,45 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "provider.theme-legacy",
+    package: "@seedgrid/fe-theme",
+    exportName: "ThemeProvider",
+    slug: "theme-provider",
+    displayName: "ThemeProvider",
+    category: "provider",
+    subcategory: "theme-legacy",
+    description: "Provider legado de tema para compatibilidade retroativa, aplicando tokens CSS e expondo contexto simplificado de tema.",
+    tags: ["provider", "theme", "legacy", "compatibility"],
+    capabilities: ["legacy-theme-context", "css-vars", "compat-layer"],
+    fieldSemantics: ["legacyThemeProvider", "themeContext", "compatibilityLayer"],
+    props: [
+        { name: "theme", type: "Partial<SeedGridThemeConfig>", description: "Configuracao parcial do tema legado.", semanticRole: "data", bindable: true },
+        { name: "children", type: "ReactNode", required: true, description: "Arvore de componentes envolvida pelo provider.", semanticRole: "data", bindable: false }
+    ],
+    states: ["default", "legacy-theme-applied"],
+    examples: [],
+    showcase: { route: "/packages/fe-theme/theme-provider", hasPlayground: false, hasPropsTable: false },
+    sdui: {
+        rendererType: "provider.theme-legacy",
+        acceptsDataBinding: true,
+        defaultProps: { theme: {} }
+    }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Manter compatibilidade com consumidores antigos do sistema de tema.",
+        "Aplicar configuracao de tema simplificada em arvores legadas.",
+        "Servir como camada de transicao entre ThemeProvider e SeedThemeProvider."
+    ],
+    avoidUseCases: [
+        "Novas implementacoes de tema; nesses casos prefira SeedThemeProvider.",
+        "Acesso ao contexto moderno de tokens; nesses casos prefira useSgTheme."
+    ],
+    synonyms: ["legacy theme provider", "theme provider compatibility", "old theme provider"],
+    relatedEntityFields: ["theme", "legacyTheme", "themeConfig"],
+    compositionHints: [
+        "Usar apenas em fluxos legados ou em migracao.",
+        "Planejar migracao gradual para SeedThemeProvider."
+    ],
+    rankingSignals: { freeText: 0.45, structuredChoice: 0.5, date: 0, number: 0, denseLayout: 0.54 }
+};

package/dist/theme/buildScaleFromHex.meta.d.ts

@@ -0,0 +1,60 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    subcategory?: string;
+    description: string;
+    tags?: string[];
+    capabilities?: string[];
+    fieldSemantics?: string[];
+    props?: SgMetaPropV0[];
+    states?: string[];
+    examples?: Array<{
+        id: string;
+        title: string;
+        file: string;
+        kind: "sample" | "playground";
+    }>;
+    showcase?: {
+        route: string;
+        hasPlayground: boolean;
+        hasPropsTable: boolean;
+    };
+    sdui?: {
+        rendererType: string;
+        acceptsDataBinding?: boolean;
+        defaultProps?: Record<string, unknown>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=buildScaleFromHex.meta.d.ts.map

package/dist/theme/buildScaleFromHex.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildScaleFromHex.meta.d.ts","sourceRoot":"","sources":["../../src/theme/buildScaleFromHex.meta.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,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,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,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,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,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,KAAK,WAAW,GAAG;IACjB,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;AAEF,eAAO,MAAM,MAAM,EAAE,QAuBpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAgBrB,CAAC"}

package/dist/theme/buildScaleFromHex.meta.js

@@ -0,0 +1,41 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "utility.build-scale-from-hex",
+    package: "@seedgrid/fe-theme",
+    exportName: "buildScaleFromHex",
+    slug: "build-scale-from-hex",
+    displayName: "buildScaleFromHex",
+    category: "utility",
+    subcategory: "color-scale",
+    description: "Gera uma escala tonal 50..900 a partir de uma cor base hexadecimal e do modo resolvido.",
+    tags: ["utility", "color", "palette", "theme"],
+    capabilities: ["palette-generation", "mode-aware-scale", "hsl-harmonization"],
+    fieldSemantics: ["colorScaleGeneration", "themePalette"],
+    props: [
+        { name: "baseHex", type: "string", required: true, description: "Cor base hexadecimal.", semanticRole: "value", bindable: true },
+        { name: "resolvedMode", type: '"light" | "dark"', required: true, description: "Modo usado para calcular a escala.", semanticRole: "behavior", bindable: true },
+        { name: "opts.boostS", type: "number", description: "Ajuste opcional de saturacao.", semanticRole: "behavior", bindable: true },
+        { name: "opts.biasL", type: "number", description: "Ajuste opcional de luminosidade.", semanticRole: "behavior", bindable: true }
+    ],
+    states: ["light", "dark"],
+    examples: [],
+    showcase: { route: "/packages/fe-theme/build-scale-from-hex", hasPlayground: false, hasPropsTable: false },
+    sdui: { rendererType: "utility.build-scale-from-hex", acceptsDataBinding: false, defaultProps: { opts: {} } }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Gerar paletas tonais a partir de uma seed color.",
+        "Construir escalas harmonizadas para tema claro e escuro."
+    ],
+    avoidUseCases: [
+        "Conversao simples de uma unica cor sem necessidade de escala.",
+        "Escolha manual de tokens quando a paleta ja estiver pronta."
+    ],
+    synonyms: ["build color scale", "palette generator", "hex scale"],
+    relatedEntityFields: ["seed", "palette", "colorScale", "mode"],
+    compositionHints: [
+        "Usar com generateThemeVars e outros utilitarios de tokenizacao."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0.2, date: 0, number: 0.54, denseLayout: 0.32 }
+};

package/dist/theme/clamp.meta.d.ts

@@ -0,0 +1,60 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    subcategory?: string;
+    description: string;
+    tags?: string[];
+    capabilities?: string[];
+    fieldSemantics?: string[];
+    props?: SgMetaPropV0[];
+    states?: string[];
+    examples?: Array<{
+        id: string;
+        title: string;
+        file: string;
+        kind: "sample" | "playground";
+    }>;
+    showcase?: {
+        route: string;
+        hasPlayground: boolean;
+        hasPropsTable: boolean;
+    };
+    sdui?: {
+        rendererType: string;
+        acceptsDataBinding?: boolean;
+        defaultProps?: Record<string, unknown>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=clamp.meta.d.ts.map

package/dist/theme/clamp.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.meta.d.ts","sourceRoot":"","sources":["../../src/theme/clamp.meta.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,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,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,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,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,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,KAAK,WAAW,GAAG;IACjB,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;AAEF,eAAO,MAAM,MAAM,EAAE,QAsBpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAgBrB,CAAC"}

package/dist/theme/clamp.meta.js

@@ -0,0 +1,40 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "utility.clamp",
+    package: "@seedgrid/fe-theme",
+    exportName: "clamp",
+    slug: "clamp",
+    displayName: "clamp",
+    category: "utility",
+    subcategory: "math",
+    description: "Funcao utilitaria para limitar um numero entre minimo e maximo.",
+    tags: ["utility", "math", "range"],
+    capabilities: ["numeric-clamp", "value-bounding"],
+    fieldSemantics: ["rangeConstraint", "numericClamp"],
+    props: [
+        { name: "n", type: "number", required: true, description: "Valor a limitar.", semanticRole: "value", bindable: true },
+        { name: "a", type: "number", required: true, description: "Limite minimo.", semanticRole: "validation", bindable: true },
+        { name: "b", type: "number", required: true, description: "Limite maximo.", semanticRole: "validation", bindable: true }
+    ],
+    states: [],
+    examples: [],
+    showcase: { route: "/packages/fe-theme/clamp", hasPlayground: false, hasPropsTable: false },
+    sdui: { rendererType: "utility.clamp", acceptsDataBinding: false, defaultProps: {} }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Limitar valores numericos em utilitarios de tema e cor.",
+        "Garantir que saturacao, luminosidade ou canais RGB fiquem dentro do intervalo valido."
+    ],
+    avoidUseCases: [
+        "Validacao complexa de dominio ou regras de negocio.",
+        "Fluxos de interface onde um input especializado seria mais apropriado."
+    ],
+    synonyms: ["clamp", "bound number", "limit value"],
+    relatedEntityFields: ["min", "max", "value"],
+    compositionHints: [
+        "Usar em helpers de cor e tokenizacao quando for preciso manter valores em faixas validas."
+    ],
+    rankingSignals: { freeText: 0, structuredChoice: 0, date: 0, number: 0.86, denseLayout: 0.15 }
+};

package/dist/theme/getSystemMode.meta.d.ts

@@ -0,0 +1,60 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    subcategory?: string;
+    description: string;
+    tags?: string[];
+    capabilities?: string[];
+    fieldSemantics?: string[];
+    props?: SgMetaPropV0[];
+    states?: string[];
+    examples?: Array<{
+        id: string;
+        title: string;
+        file: string;
+        kind: "sample" | "playground";
+    }>;
+    showcase?: {
+        route: string;
+        hasPlayground: boolean;
+        hasPropsTable: boolean;
+    };
+    sdui?: {
+        rendererType: string;
+        acceptsDataBinding?: boolean;
+        defaultProps?: Record<string, unknown>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=getSystemMode.meta.d.ts.map

package/dist/theme/getSystemMode.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSystemMode.meta.d.ts","sourceRoot":"","sources":["../../src/theme/getSystemMode.meta.ts"],"names":[],"mappings":"AAAA,KAAK,YAAY,GAAG;IAClB,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,KAAK,QAAQ,GAAG;IACd,OAAO,EAAE,KAAK,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,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,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,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,KAAK,WAAW,GAAG;IACjB,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;AAEF,eAAO,MAAM,MAAM,EAAE,QAkBpB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAgBrB,CAAC"}

package/dist/theme/getSystemMode.meta.js

@@ -0,0 +1,36 @@
+export const sgMeta = {
+    version: "0.1",
+    componentId: "utility.get-system-mode",
+    package: "@seedgrid/fe-theme",
+    exportName: "getSystemMode",
+    slug: "get-system-mode",
+    displayName: "getSystemMode",
+    category: "utility",
+    subcategory: "system-mode",
+    description: "Resolve o modo claro ou escuro com base na preferencia do sistema operacional no browser.",
+    tags: ["utility", "theme", "dark-mode", "system-preference"],
+    capabilities: ["prefers-color-scheme", "light-dark-resolution", "browser-aware"],
+    fieldSemantics: ["systemModeDetection", "preferredColorScheme"],
+    props: [],
+    states: ["light", "dark"],
+    examples: [],
+    showcase: { route: "/packages/fe-theme/get-system-mode", hasPlayground: false, hasPropsTable: false },
+    sdui: { rendererType: "utility.get-system-mode", acceptsDataBinding: false, defaultProps: {} }
+};
+export const aiHints = {
+    version: "0.1",
+    preferredUseCases: [
+        "Detectar preferencia inicial de claro ou escuro no cliente.",
+        "Apoiar modos automaticos de tema baseados em prefers-color-scheme."
+    ],
+    avoidUseCases: [
+        "Persistencia da escolha do usuario; isso deve ser tratado por provider ou storage.",
+        "Uso em ambiente puramente server-side como fonte definitiva de tema."
+    ],
+    synonyms: ["system mode", "prefers color scheme", "detect dark mode"],
+    relatedEntityFields: ["mode", "systemMode", "colorScheme"],
+    compositionHints: [
+        "Usar com SeedThemeProvider quando o modo auto precisar de fallback para o sistema."
+    ],
+    rankingSignals: { freeText: 0.2, structuredChoice: 0.36, date: 0, number: 0, denseLayout: 0.22 }
+};

package/dist/theme/useSgTheme.meta.d.ts

@@ -0,0 +1,61 @@
+type SgMetaPropV0 = {
+    name: string;
+    type: string;
+    required?: boolean;
+    default?: unknown;
+    description?: string;
+    semanticRole?: "value" | "label" | "validation" | "behavior" | "appearance" | "event" | "data";
+    bindable?: boolean;
+};
+type SgMetaExampleV0 = {
+    id: string;
+    title: string;
+    file: string;
+    kind: "sample" | "playground";
+};
+type SgMetaV0 = {
+    version: "0.1";
+    componentId: string;
+    package: string;
+    exportName: string;
+    slug: string;
+    displayName: string;
+    category: string;
+    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>;
+    };
+};
+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;
+    };
+};
+export declare const sgMeta: SgMetaV0;
+export declare const aiHints: SgAiHintsV0;
+export {};
+//# sourceMappingURL=useSgTheme.meta.d.ts.map