forlogic-core 1.16.3 → 1.16.5

package/dist/assets/SecurityDoc-Chbt6w1s.js

@@ -1,204 +0,0 @@
-import{j as e,C as s,B as r,aq as n,aA as c,b7 as d,aC as l,bZ as o,ba as p,bB as m,bd as u}from"./index-BtX5DZqb.js";import{C as g}from"./ComponentDocTemplate-BtOCnlM2.js";import{S as f}from"./server-XQDXtrjm.js";import{G as x}from"./globe-BdFDFP_k.js";import"./ExampleCard-DfuMYM6E.js";import"./TableOfContents-DBMJMbI4.js";function h(){return e.jsx("div",{className:"space-y-6",children:e.jsxs("div",{className:"grid gap-4 md:grid-cols-2 lg:grid-cols-4",children:[e.jsxs(s,{className:"p-4 border-2",children:[e.jsxs("div",{className:"flex items-center gap-3 mb-2",children:[e.jsx("div",{className:"p-2 rounded-lg bg-green-500/10",children:e.jsx(o,{className:"h-5 w-5 text-green-500"})}),e.jsx("h4",{className:"font-semibold",children:"CSP"})]}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Content Security Policy para prevenir XSS e injeção de código"})]}),e.jsxs(s,{className:"p-4 border-2",children:[e.jsxs("div",{className:"flex items-center gap-3 mb-2",children:[e.jsx("div",{className:"p-2 rounded-lg bg-blue-500/10",children:e.jsx(x,{className:"h-5 w-5 text-blue-500"})}),e.jsx("h4",{className:"font-semibold",children:"CORS"})]}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Controle de origens confiáveis sem usar wildcards inseguros"})]}),e.jsxs(s,{className:"p-4 border-2",children:[e.jsxs("div",{className:"flex items-center gap-3 mb-2",children:[e.jsx("div",{className:"p-2 rounded-lg bg-orange-500/10",children:e.jsx(m,{className:"h-5 w-5 text-orange-500"})}),e.jsx("h4",{className:"font-semibold",children:"HSTS"})]}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Força HTTPS com preload e inclusão de subdomínios"})]}),e.jsxs(s,{className:"p-4 border-2",children:[e.jsxs("div",{className:"flex items-center gap-3 mb-2",children:[e.jsx("div",{className:"p-2 rounded-lg bg-purple-500/10",children:e.jsx(u,{className:"h-5 w-5 text-purple-500"})}),e.jsx("h4",{className:"font-semibold",children:"Headers OWASP"})]}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Headers recomendados pela OWASP para proteção adicional"})]})]})})}function v(){const i=[{name:"Strict-Transport-Security",value:"max-age=31536000; includeSubDomains; preload",desc:"Força HTTPS por 1 ano"},{name:"X-Content-Type-Options",value:"nosniff",desc:"Previne MIME sniffing"},{name:"X-Frame-Options",value:"DENY",desc:"Bloqueia iframe embedding"},{name:"X-XSS-Protection",value:"1; mode=block",desc:"Filtro XSS do navegador"},{name:"Referrer-Policy",value:"strict-origin-when-cross-origin",desc:"Controla vazamento de referrer"},{name:"Permissions-Policy",value:"camera=(), microphone=()...",desc:"Desabilita APIs sensíveis"}];return e.jsxs(s,{className:"p-4 bg-muted/50",children:[e.jsxs("h4",{className:"font-semibold mb-3 flex items-center gap-2",children:[e.jsx(f,{className:"h-4 w-4"}),"Headers de Segurança Aplicados"]}),e.jsx("div",{className:"overflow-x-auto",children:e.jsxs("table",{className:"w-full text-sm",children:[e.jsx("thead",{children:e.jsxs("tr",{className:"border-b",children:[e.jsx("th",{className:"text-left py-2 px-3 font-medium",children:"Header"}),e.jsx("th",{className:"text-left py-2 px-3 font-medium",children:"Valor"}),e.jsx("th",{className:"text-left py-2 px-3 font-medium",children:"Proteção"})]})}),e.jsx("tbody",{className:"divide-y",children:i.map((a,t)=>e.jsxs("tr",{children:[e.jsx("td",{className:"py-2 px-3",children:e.jsx("code",{className:"text-xs",children:a.name})}),e.jsx("td",{className:"py-2 px-3 text-muted-foreground text-xs font-mono",children:a.value}),e.jsx("td",{className:"py-2 px-3 text-muted-foreground text-xs",children:a.desc})]},t))})]})})]})}function j(){const i=[{name:"default-src",value:"'self'",prod:!0,dev:!0},{name:"script-src",value:"'self' + CDNs",prod:!0,dev:!0},{name:"style-src",value:"'self' + fonts",prod:!0,dev:!0},{name:"connect-src",value:"'self' + Supabase",prod:!0,dev:!0},{name:"img-src",value:"'self' data: https:",prod:!0,dev:!0},{name:"frame-ancestors",value:"'self' lovable.dev",prod:!0,dev:!0},{name:"upgrade-insecure-requests",value:"(automático)",prod:!0,dev:!1},{name:"require-trusted-types-for",value:"'script'",prod:!0,dev:!1}];return e.jsxs(s,{className:"p-4 space-y-3",children:[e.jsxs("h4",{className:"font-medium flex items-center gap-2",children:[e.jsx(p,{className:"h-4 w-4"}),"Diretivas CSP"]}),e.jsx("div",{className:"space-y-2",children:i.map((a,t)=>e.jsxs("div",{className:"flex items-center justify-between text-sm py-1 border-b last:border-0",children:[e.jsxs("div",{className:"flex items-center gap-2",children:[e.jsx("code",{className:"text-xs bg-muted px-1 rounded",children:a.name}),e.jsx("span",{className:"text-muted-foreground text-xs",children:a.value})]}),e.jsxs("div",{className:"flex gap-1",children:[a.prod&&e.jsx(r,{variant:"secondary",className:"text-[10px]",children:"PROD"}),a.dev&&e.jsx(r,{variant:"outline",className:"text-[10px]",children:"DEV"})]})]},t))})]})}function O(){return e.jsx(g,{title:"Segurança (Vite Config)",description:"Plugin de segurança para Vite que aplica headers OWASP, CSP configurável, CORS seguro e proteções contra ataques comuns. Configuração centralizada para todos os projetos Forlogic.",installation:`// vite.config.ts
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react-swc';
-import path from 'path';
-import { createForlogicViteConfig } from 'forlogic-core/vite';
-
-const forlogicConfig = createForlogicViteConfig({
-  security: {
-    supabaseUrls: ['https://seu-projeto.supabase.co'],
-    trustedOrigins: ['https://seu-app.com'],
-  },
-});
-
-export default defineConfig(({ mode }) => {
-  const isDev = mode === 'development';
-  const baseConfig = forlogicConfig(isDev);
-  
-  return {
-    ...baseConfig,
-    plugins: [react(), ...baseConfig.plugins],
-    resolve: {
-      alias: {
-        '@': path.resolve(__dirname, './src'),
-      },
-    },
-  };
-});`,component:e.jsx(h,{}),usage:`// Importar do módulo /vite
-import { 
-  createForlogicViteConfig,
-  createSecurityHeadersPlugin,
-  defaultForlogicViteConfig 
-} from 'forlogic-core/vite';
-
-// Opção 1: Configuração completa (recomendado)
-const forlogicConfig = createForlogicViteConfig({
-  security: { ... },
-  server: { port: 3000 },
-  build: { sourcemap: true },
-});
-
-// Opção 2: Apenas plugin de segurança
-const securityPlugin = createSecurityHeadersPlugin(isDev, {
-  supabaseUrls: ['https://xyz.supabase.co'],
-});
-
-// Opção 3: Configuração padrão mínima
-const baseConfig = defaultForlogicViteConfig(isDev);`,examples:[{title:"Headers de Segurança OWASP",description:"Headers aplicados automaticamente seguindo recomendações OWASP",preview:e.jsx(v,{}),code:`// Headers aplicados automaticamente pelo plugin:
-
-// HSTS - Força HTTPS por 1 ano
-'Strict-Transport-Security': 'max-age=31536000; includeSubDomains; preload'
-
-// Previne MIME type sniffing
-'X-Content-Type-Options': 'nosniff'
-
-// Bloqueia embedding em iframes (proteção clickjacking)
-'X-Frame-Options': 'DENY'
-
-// Ativa filtro XSS do navegador
-'X-XSS-Protection': '1; mode=block'
-
-// Controla vazamento de informações via referrer
-'Referrer-Policy': 'strict-origin-when-cross-origin'
-
-// Desabilita APIs potencialmente perigosas
-'Permissions-Policy': 'camera=(), microphone=(), geolocation=(), fullscreen=(self), payment=(), display-capture=()'`},{title:"Content Security Policy (CSP)",description:"Política de segurança de conteúdo configurável por ambiente",preview:e.jsx(j,{}),code:`// CSP gerado automaticamente baseado no ambiente
-
-// DESENVOLVIMENTO: Permite HMR e eval do Vite
-"script-src 'self' https://cdn.gpteng.co 'unsafe-inline' 'unsafe-eval'"
-"style-src 'self' https://fonts.googleapis.com 'unsafe-inline'"
-
-// PRODUÇÃO: CSP estrito
-"script-src 'self' https://cdn.gpteng.co"
-"style-src 'self' https://fonts.googleapis.com"
-"require-trusted-types-for 'script'"
-"upgrade-insecure-requests"
-
-// Customizar via opções:
-createForlogicViteConfig({
-  security: {
-    additionalScriptSrc: ['https://cdn.minha-lib.com'],
-    additionalStyleSrc: ['https://fonts.custom.com'],
-    additionalConnectSrc: ['https://api.terceiros.com'],
-    cspReportUri: 'https://meu-app.com/csp-report',
-    enableTrustedTypes: true,
-    upgradeInsecureRequests: true,
-  }
-});`},{title:"CORS Seguro",description:"Controle de origens sem usar wildcards (*) com credenciais",preview:e.jsxs(s,{className:"p-4 space-y-4",children:[e.jsxs("div",{className:"space-y-2",children:[e.jsx("h4",{className:"font-medium text-sm",children:"Origens Confiáveis Padrão:"}),e.jsxs("div",{className:"flex flex-wrap gap-2",children:[e.jsx(r,{variant:"secondary",children:"lovableproject.com"}),e.jsx(r,{variant:"secondary",children:"lovable.dev"}),e.jsx(r,{variant:"outline",children:"localhost:* (dev)"})]})]}),e.jsx(n,{}),e.jsxs("div",{className:"space-y-2",children:[e.jsx("h4",{className:"font-medium text-sm",children:"Origens Customizadas:"}),e.jsxs("div",{className:"flex flex-wrap gap-2",children:[e.jsx(r,{children:"seu-app.com"}),e.jsx(r,{children:"admin.seu-app.com"})]})]})]}),code:`// CORS seguro - nunca usa '*' com credenciais
-
-createForlogicViteConfig({
-  security: {
-    trustedOrigins: [
-      'https://seu-app.com',
-      'https://admin.seu-app.com',
-      'https://*.subdominio.com', // Suporte a wildcards
-    ],
-  }
-});
-
-// Headers CORS aplicados quando origem é confiável:
-'Access-Control-Allow-Origin': origin  // Origem específica, nunca '*'
-'Access-Control-Allow-Credentials': 'true'
-'Access-Control-Allow-Methods': 'GET, POST, PUT, PATCH, DELETE, OPTIONS'
-'Access-Control-Allow-Headers': 'authorization, x-client-info, apikey, content-type, x-csrf-token, x-nonce'
-'Access-Control-Max-Age': '86400'
-'Vary': 'Origin'
-
-// ⚠️ Origens não confiáveis são bloqueadas e logadas:
-// 🚨 CORS BLOCKED: Untrusted origin attempted access: https://malicious.com`},{title:"Opções Completas de Configuração",description:"Todas as opções disponíveis para personalização",preview:e.jsxs(s,{className:"p-4 space-y-3",children:[e.jsx("h4",{className:"font-medium",children:"ForlogicViteOptions:"}),e.jsxs("div",{className:"text-sm space-y-2",children:[e.jsxs("div",{className:"flex justify-between py-1 border-b",children:[e.jsx("code",{className:"text-xs",children:"security"}),e.jsx("span",{className:"text-muted-foreground text-xs",children:"SecurityHeadersOptions"})]}),e.jsxs("div",{className:"flex justify-between py-1 border-b",children:[e.jsx("code",{className:"text-xs",children:"server"}),e.jsx("span",{className:"text-muted-foreground text-xs",children:"{ host, port }"})]}),e.jsxs("div",{className:"flex justify-between py-1 border-b",children:[e.jsx("code",{className:"text-xs",children:"build"}),e.jsx("span",{className:"text-muted-foreground text-xs",children:"{ chunkSizeWarningLimit, sourcemap }"})]}),e.jsxs("div",{className:"flex justify-between py-1 border-b",children:[e.jsx("code",{className:"text-xs",children:"additionalPlugins"}),e.jsx("span",{className:"text-muted-foreground text-xs",children:"VitePlugin[]"})]}),e.jsxs("div",{className:"flex justify-between py-1",children:[e.jsx("code",{className:"text-xs",children:"disableSecurity"}),e.jsx("span",{className:"text-muted-foreground text-xs",children:"boolean (não recomendado)"})]})]})]}),code:`import { createForlogicViteConfig } from 'forlogic-core/vite';
-
-const forlogicConfig = createForlogicViteConfig({
-  // Configurações de segurança
-  security: {
-    supabaseUrls: ['https://xyz.supabase.co'],
-    trustedOrigins: ['https://meu-app.com'],
-    additionalScriptSrc: [],
-    additionalStyleSrc: [],
-    additionalConnectSrc: ['https://api.terceiros.com'],
-    cspReportUri: 'https://meu-app.com/csp-violations',
-    enableTrustedTypes: true,
-    upgradeInsecureRequests: true,
-  },
-  
-  // Configurações do servidor dev
-  server: {
-    host: '::',
-    port: 8080,
-  },
-  
-  // Configurações de build
-  build: {
-    chunkSizeWarningLimit: 4000,
-    sourcemap: true,
-  },
-  
-  // Plugins Vite adicionais
-  additionalPlugins: [],
-  
-  // ⚠️ Desabilitar segurança (NÃO RECOMENDADO)
-  disableSecurity: false,
-});`},{title:"Exemplo Completo vite.config.ts",description:"Configuração completa pronta para uso em produção",preview:e.jsxs(c,{children:[e.jsx(d,{className:"h-4 w-4 text-green-500"}),e.jsx(l,{children:e.jsxs("div",{className:"space-y-1 text-sm",children:[e.jsx("p",{className:"font-medium",children:"Configuração pronta para produção:"}),e.jsx("p",{children:"• Headers OWASP aplicados automaticamente"}),e.jsx("p",{children:"• CSP estrito em produção"}),e.jsx("p",{children:"• CORS seguro sem wildcards"}),e.jsx("p",{children:"• Trusted Types habilitado"})]})})]}),code:`// vite.config.ts
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react-swc';
-import path from 'path';
-import { createForlogicViteConfig } from 'forlogic-core/vite';
-
-const forlogicConfig = createForlogicViteConfig({
-  security: {
-    supabaseUrls: [
-      'https://tskpcuganynhsppzoqgj.supabase.co',
-      'https://ccjfvpnndclajkleyqkc.supabase.co',
-    ],
-    trustedOrigins: [
-      'https://meu-app.lovable.app',
-      'https://meu-dominio.com',
-    ],
-    additionalConnectSrc: [
-      'https://api.qualiex.com',
-    ],
-  },
-});
-
-export default defineConfig(({ mode }) => {
-  const isDev = mode === 'development';
-  const baseConfig = forlogicConfig(isDev);
-  
-  return {
-    ...baseConfig,
-    plugins: [react(), ...baseConfig.plugins],
-    resolve: {
-      alias: {
-        // ⚠️ IMPORTANTE: Usar path.resolve() para caminhos absolutos
-        '@': path.resolve(__dirname, './src'),
-      },
-    },
-    // Sobrescrever configurações se necessário
-    server: {
-      ...baseConfig.server,
-      port: 3000, // Porta customizada
-    },
-    // Forçar re-bundle de dependências
-    optimizeDeps: {
-      force: true,
-    },
-  };
-});`},{title:"Apenas Plugin de Segurança",description:"Usar somente o plugin de headers sem a configuração completa",preview:e.jsxs(s,{className:"p-4 space-y-2",children:[e.jsxs("div",{className:"flex items-center gap-2",children:[e.jsx(o,{className:"h-5 w-5 text-green-500"}),e.jsx("span",{className:"font-medium",children:"createSecurityHeadersPlugin"})]}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Use quando você já tem uma configuração Vite e quer adicionar apenas os headers de segurança."})]}),code:`// vite.config.ts existente
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react-swc';
-import { createSecurityHeadersPlugin } from 'forlogic-core/vite';
-
-export default defineConfig(({ mode }) => {
-  const isDev = mode === 'development';
-  
-  return {
-    plugins: [
-      react(),
-      // Adicionar apenas o plugin de segurança
-      createSecurityHeadersPlugin(isDev, {
-        supabaseUrls: ['https://xyz.supabase.co'],
-        trustedOrigins: ['https://meu-app.com'],
-      }),
-    ],
-    // ... resto da sua configuração
-  };
-});`}],props:[{name:"supabaseUrls",type:"string[]",default:"[]",description:"URLs do Supabase para permitir em connect-src."},{name:"trustedOrigins",type:"string[]",default:"[]",description:"Origens confiáveis para CORS (suporta wildcards *.dominio.com)."},{name:"additionalScriptSrc",type:"string[]",default:"[]",description:"CDNs e fontes de script adicionais para CSP."},{name:"additionalStyleSrc",type:"string[]",default:"[]",description:"Fontes de estilo adicionais (fontes, CSS CDNs)."},{name:"additionalConnectSrc",type:"string[]",default:"[]",description:"APIs e WebSockets adicionais para CSP."},{name:"cspReportUri",type:"string",default:"-",description:"URI para receber relatórios de violações CSP."},{name:"enableTrustedTypes",type:"boolean",default:"true",description:"Habilitar Trusted Types em produção (proteção XSS)."},{name:"upgradeInsecureRequests",type:"boolean",default:"true",description:"Atualizar automaticamente HTTP para HTTPS em produção."},{name:"server.host",type:"string",default:'"::"',description:"Host do servidor de desenvolvimento."},{name:"server.port",type:"number",default:"8080",description:"Porta do servidor de desenvolvimento."},{name:"build.sourcemap",type:"boolean",default:"true",description:"Gerar sourcemaps para debug."},{name:"build.chunkSizeWarningLimit",type:"number",default:"4000",description:"Limite de tamanho de chunk (KB) para avisos."},{name:"disableSecurity",type:"boolean",default:"false",description:"Desabilitar plugin de segurança (NÃO recomendado)."}],accessibility:["Os headers de segurança protegem usuários de ataques como XSS, clickjacking e MIME sniffing.","CSP estrito em produção previne execução de scripts maliciosos.","CORS seguro impede vazamento de dados para origens não autorizadas.","Trusted Types fornece proteção adicional contra injeção de DOM."],notes:['**IMPORTANTE**: O alias `@` deve ser configurado com `path.resolve(__dirname, "./src")` - caminhos relativos falham no build.',"Em **desenvolvimento**, CSP permite unsafe-inline e unsafe-eval para suportar HMR do Vite.","Em **produção**, CSP é estrito e inclui Trusted Types e upgrade-insecure-requests.","Origens não confiáveis são **logadas** no console para auditoria de segurança.","Use `cspReportUri` para receber relatórios de violações e monitorar ataques.","O plugin é aplicado apenas ao **servidor de desenvolvimento** - em produção, configure headers no seu servidor/CDN."]})}export{O as SecurityDoc};

package/dist/assets/SelectDoc-BhcpBIAO.js

@@ -1,80 +0,0 @@
-import{j as e,cX as t,cY as a,cZ as c,c_ as r,c$ as l,d0 as n,d1 as i,L as s}from"./index-BtX5DZqb.js";import{C as o}from"./ComponentDocTemplate-BtOCnlM2.js";import"./ExampleCard-DfuMYM6E.js";import"./TableOfContents-DBMJMbI4.js";function m(){return e.jsx(o,{title:"Select",description:"Exibe uma lista de opções para o usuário escolher—acionada por um botão.",component:e.jsxs(t,{children:[e.jsx(a,{className:"w-[180px]",children:e.jsx(c,{placeholder:"Select a fruit"})}),e.jsxs(r,{children:[e.jsx(l,{value:"apple",children:"Apple"}),e.jsx(l,{value:"banana",children:"Banana"}),e.jsx(l,{value:"orange",children:"Orange"})]})]}),usage:`import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "forlogic-core"
-
-<Select>
-  <SelectTrigger className="w-[180px]">
-    <SelectValue placeholder="Theme" />
-  </SelectTrigger>
-  <SelectContent>
-    <SelectItem value="light">Light</SelectItem>
-    <SelectItem value="dark">Dark</SelectItem>
-  </SelectContent>
-</Select>`,examples:[{title:"Select Básico",preview:e.jsxs(t,{children:[e.jsx(a,{className:"w-[280px]",children:e.jsx(c,{placeholder:"Select a fruit"})}),e.jsxs(r,{children:[e.jsx(l,{value:"apple",children:"Apple"}),e.jsx(l,{value:"banana",children:"Banana"}),e.jsx(l,{value:"orange",children:"Orange"}),e.jsx(l,{value:"grape",children:"Grape"})]})]}),code:`<Select>
-  <SelectTrigger className="w-[280px]">
-    <SelectValue placeholder="Select a fruit" />
-  </SelectTrigger>
-  <SelectContent>
-    <SelectItem value="apple">Apple</SelectItem>
-    <SelectItem value="banana">Banana</SelectItem>
-    <SelectItem value="orange">Orange</SelectItem>
-  </SelectContent>
-</Select>`},{title:"Com Grupos",preview:e.jsxs(t,{children:[e.jsx(a,{className:"w-[280px]",children:e.jsx(c,{placeholder:"Select a timezone"})}),e.jsxs(r,{children:[e.jsxs(n,{children:[e.jsx(i,{children:"North America"}),e.jsx(l,{value:"est",children:"Eastern Standard Time (EST)"}),e.jsx(l,{value:"cst",children:"Central Standard Time (CST)"}),e.jsx(l,{value:"pst",children:"Pacific Standard Time (PST)"})]}),e.jsxs(n,{children:[e.jsx(i,{children:"Europe"}),e.jsx(l,{value:"gmt",children:"Greenwich Mean Time (GMT)"}),e.jsx(l,{value:"cet",children:"Central European Time (CET)"})]})]})]}),code:`<Select>
-  <SelectTrigger>
-    <SelectValue placeholder="Select a timezone" />
-  </SelectTrigger>
-  <SelectContent>
-    <SelectGroup>
-      <SelectLabel>North America</SelectLabel>
-      <SelectItem value="est">Eastern Standard Time (EST)</SelectItem>
-      <SelectItem value="cst">Central Standard Time (CST)</SelectItem>
-    </SelectGroup>
-    <SelectGroup>
-      <SelectLabel>Europe</SelectLabel>
-      <SelectItem value="gmt">Greenwich Mean Time (GMT)</SelectItem>
-    </SelectGroup>
-  </SelectContent>
-</Select>`},{title:"Estados",preview:e.jsxs("div",{className:"space-y-4",children:[e.jsxs(t,{children:[e.jsx(a,{className:"w-[280px]",children:e.jsx(c,{placeholder:"Normal state"})}),e.jsxs(r,{children:[e.jsx(l,{value:"1",children:"Option 1"}),e.jsx(l,{value:"2",children:"Option 2"})]})]}),e.jsxs(t,{disabled:!0,children:[e.jsx(a,{className:"w-[280px]",children:e.jsx(c,{placeholder:"Disabled state"})}),e.jsx(r,{children:e.jsx(l,{value:"1",children:"Option 1"})})]})]}),code:`<Select>
-  <SelectTrigger>
-    <SelectValue placeholder="Normal state" />
-  </SelectTrigger>
-  <SelectContent>
-    <SelectItem value="1">Option 1</SelectItem>
-  </SelectContent>
-</Select>
-
-<Select disabled>
-  <SelectTrigger>
-    <SelectValue placeholder="Disabled state" />
-  </SelectTrigger>
-  <SelectContent>
-    <SelectItem value="1">Option 1</SelectItem>
-  </SelectContent>
-</Select>`},{title:"Com Label",preview:e.jsxs("div",{className:"space-y-2 w-[280px]",children:[e.jsx(s,{htmlFor:"country",children:"Country"}),e.jsxs(t,{children:[e.jsx(a,{id:"country",children:e.jsx(c,{placeholder:"Select your country"})}),e.jsxs(r,{children:[e.jsx(l,{value:"br",children:"Brazil"}),e.jsx(l,{value:"us",children:"United States"}),e.jsx(l,{value:"uk",children:"United Kingdom"}),e.jsx(l,{value:"ca",children:"Canada"})]})]})]}),code:`<div className="space-y-2">
-  <Label htmlFor="country">Country</Label>
-  <Select>
-    <SelectTrigger id="country">
-      <SelectValue placeholder="Select your country" />
-    </SelectTrigger>
-    <SelectContent>
-      <SelectItem value="br">Brazil</SelectItem>
-      <SelectItem value="us">United States</SelectItem>
-    </SelectContent>
-  </Select>
-</div>`},{title:"Casos de Uso - Form",preview:e.jsxs("div",{className:"space-y-4 w-[280px]",children:[e.jsxs("div",{className:"space-y-2",children:[e.jsx(s,{htmlFor:"role",children:"User Role"}),e.jsxs(t,{children:[e.jsx(a,{id:"role",children:e.jsx(c,{placeholder:"Select a role"})}),e.jsxs(r,{children:[e.jsx(l,{value:"admin",children:"Administrator"}),e.jsx(l,{value:"user",children:"User"}),e.jsx(l,{value:"guest",children:"Guest"})]})]})]}),e.jsxs("div",{className:"space-y-2",children:[e.jsx(s,{htmlFor:"status",children:"Status"}),e.jsxs(t,{children:[e.jsx(a,{id:"status",children:e.jsx(c,{placeholder:"Select status"})}),e.jsxs(r,{children:[e.jsx(l,{value:"active",children:"Active"}),e.jsx(l,{value:"inactive",children:"Inactive"}),e.jsx(l,{value:"pending",children:"Pending"})]})]})]})]}),code:`<div className="space-y-2">
-  <Label htmlFor="role">User Role</Label>
-  <Select>
-    <SelectTrigger id="role">
-      <SelectValue placeholder="Select a role" />
-    </SelectTrigger>
-    <SelectContent>
-      <SelectItem value="admin">Administrator</SelectItem>
-      <SelectItem value="user">User</SelectItem>
-      <SelectItem value="guest">Guest</SelectItem>
-    </SelectContent>
-  </Select>
-</div>`}],props:[{name:"defaultValue",type:"string",default:"-",description:"O valor selecionado padrão."},{name:"value",type:"string",default:"-",description:"O valor selecionado controlado."},{name:"onValueChange",type:"(value: string) => void",default:"-",description:"Manipulador de evento quando o valor muda."},{name:"disabled",type:"boolean",default:"false",description:"Se o select está desabilitado."},{name:"container (SelectContent)",type:"HTMLElement",default:"-",description:"Container HTML para portal (útil dentro de Dialog)."},{name:"collisionBoundary (SelectContent)",type:"HTMLElement",default:"-",description:"Elemento para detecção de colisão de posicionamento."}],accessibility:["Navegação completa por teclado","Busca por digitação antecipada","Segue o padrão de listbox WAI-ARIA","Anúncios para leitores de tela"],notes:["💡 Use `container` e `collisionBoundary` quando o Select estiver dentro de um Dialog para evitar problemas de scroll","💡 Para seleção com busca, considere usar `Combobox` ao invés de `Select`"]})}export{m as SelectDoc};

package/dist/assets/SeparatorDoc-C3fhatb0.js

@@ -1,4 +0,0 @@
-import{j as e,aq as t}from"./index-BtX5DZqb.js";import{C as a}from"./ComponentDocTemplate-BtOCnlM2.js";import"./ExampleCard-DfuMYM6E.js";import"./TableOfContents-DBMJMbI4.js";function c(){return e.jsx(a,{title:"Separator",description:"Separa visual ou semanticamente o conteúdo.",component:e.jsxs("div",{className:"space-y-4 w-full max-w-md",children:[e.jsxs("div",{children:[e.jsx("h4",{className:"text-sm font-medium",children:"Primitivos Radix"}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Uma biblioteca de componentes UI de código aberto."})]}),e.jsx(t,{}),e.jsxs("div",{children:[e.jsx("h4",{className:"text-sm font-medium",children:"Recursos"}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Acessível, customizável, código aberto."})]})]}),usage:`import { Separator } from "forlogic-core"
-
-<Separator />
-<Separator orientation="vertical" />`,examples:[{title:"Horizontal",preview:e.jsxs("div",{className:"w-full max-w-md space-y-2",children:[e.jsx("p",{className:"text-sm",children:"Conteúdo acima"}),e.jsx(t,{}),e.jsx("p",{className:"text-sm",children:"Conteúdo abaixo"})]}),code:"<Separator />"},{title:"Vertical",preview:e.jsxs("div",{className:"flex h-20 items-center gap-4",children:[e.jsx("p",{className:"text-sm",children:"Esquerda"}),e.jsx(t,{orientation:"vertical"}),e.jsx("p",{className:"text-sm",children:"Direita"})]}),code:'<Separator orientation="vertical" />'}],props:[{name:"orientation",type:'"horizontal" | "vertical"',default:'"horizontal"',description:"A orientação do separador."},{name:"decorative",type:"boolean",default:"true",description:"Se o separador é decorativo ou semântico."}],accessibility:["HTML semântico com role adequado","Pode ser decorativo ou estrutural","Atributos ARIA adequados"]})}export{c as SeparatorDoc};

package/dist/assets/ServicesDoc-_uao-HA_.js

@@ -1,308 +0,0 @@
-import{j as e}from"./index-BtX5DZqb.js";import{C as o}from"./ComponentDocTemplate-BtOCnlM2.js";import"./ExampleCard-DfuMYM6E.js";import"./TableOfContents-DBMJMbI4.js";const t=`import { 
-  // Services
-  createService,
-  emailService,
-  errorService,
-  // Qualiex Enrichment
-  QualiexEnrichmentService,
-  resolveFieldMappings,
-  deriveNameField,
-  deriveEmailField,
-  deriveUsernameField,
-} from 'forlogic-core';`,d=`import { createService } from 'forlogic-core';
-
-// Definir tipos
-interface Employee {
-  id: string;
-  name: string;
-  email: string;
-  department_id: string;
-  is_removed: boolean;
-  created_at: string;
-  updated_at: string;
-}
-
-interface EmployeeInsert {
-  name: string;
-  email: string;
-  department_id: string;
-}
-
-interface EmployeeUpdate {
-  name?: string;
-  email?: string;
-  department_id?: string;
-}
-
-// Criar serviço CRUD
-const employeeService = createService<Employee, EmployeeInsert, EmployeeUpdate>({
-  tableName: 'employees',
-  schemaName: 'common',
-  searchFields: ['name', 'email'],
-  selectFields: '*, departments(name)',  // Joins automáticos
-  enableQualiexEnrichment: true,          // Enriquecer com dados do Qualiex
-  userIdFields: ['id_user'],              // Campos de usuário para enriquecimento
-});
-
-// Uso do serviço
-async function loadEmployees() {
-  // Buscar com paginação e filtros
-  const result = await employeeService.getAll({
-    search: 'João',
-    sortField: 'name',
-    sortDirection: 'asc',
-    page: 1,
-    limit: 25,
-    department_id: 'dept-123',  // Filtro adicional
-  });
-  
-  console.log(result.data);           // Array de funcionários
-  console.log(result.totalItems);     // Total de registros
-  console.log(result.hasNextPage);    // Se há próxima página
-}
-
-// CRUD completo
-const employee = await employeeService.create({
-  name: 'Maria Silva',
-  email: 'maria@empresa.com',
-  department_id: 'dept-123'
-});
-
-const updated = await employeeService.update(employee.id, {
-  name: 'Maria Santos'
-});
-
-await employeeService.delete(employee.id);  // Soft delete (is_removed = true)`,n=`import { emailService } from 'forlogic-core';
-
-// Enviar email de boas-vindas
-await emailService.sendEmail({
-  templateCode: 'WELCOME',
-  to: 'usuario@exemplo.com',
-  variables: {
-    userName: 'João Silva',
-    activationLink: 'https://app.com/activate',
-    companyName: 'Minha Empresa'
-  }
-});
-
-// Enviar para múltiplos destinatários com cópia
-await emailService.sendEmail({
-  templateCode: 'NOTIFICATION',
-  to: ['usuario1@exemplo.com', 'usuario2@exemplo.com'],
-  variables: {
-    title: 'Novo documento disponível',
-    message: 'Um novo documento foi compartilhado com você',
-    actionUrl: 'https://app.com/documents/123',
-    actionLabel: 'Ver Documento'
-  },
-  cc: ['gestor@exemplo.com'],
-  bcc: ['admin@exemplo.com'],
-  replyTo: 'suporte@empresa.com'
-});
-
-// Templates são cadastrados na tabela common.email_templates
-// Variáveis são substituídas automaticamente: {{userName}} -> João Silva`,l=`import { errorService } from 'forlogic-core';
-
-// Tratamento de erros com toast automático
-try {
-  await fetchData();
-} catch (error) {
-  errorService.handleError(error);
-  // Exibe toast com título apropriado baseado no erro
-  // Ex: "Sessão Expirada", "Erro de Conexão", "Erro de Autenticação"
-}
-
-// Tratamento silencioso (sem toast)
-try {
-  await fetchData();
-} catch (error) {
-  errorService.handleError(error, false);  // showToast = false
-}
-
-// Notificação de sucesso
-errorService.success('Sucesso!', 'Dados salvos com sucesso');
-
-// Acessar histórico de erros
-const recentErrors = errorService.getErrors();  // Últimos 50 erros
-console.log(recentErrors);
-
-// Limpar histórico
-errorService.clearErrors();
-
-// Rate limiting automático: máximo 3 toasts por minuto`,m=`import { QualiexEnrichmentService } from 'forlogic-core';
-
-// Enriquecer entidades com dados de usuário do Qualiex
-// Adiciona automaticamente: nome, email, username dos usuários
-
-// Uso simples: lista de campos de ID
-const enrichedItems = await QualiexEnrichmentService.enrichWithUserData(items, {
-  entityName: 'Avaliações',
-  userIdFields: ['target_user_id', 'evaluator_user_id']
-});
-// Resultado: target_user_name, evaluator_user_name preenchidos automaticamente
-
-// Uso avançado: mapeamento customizado de campos
-const enrichedItems = await QualiexEnrichmentService.enrichWithUserData(items, {
-  entityName: 'Avaliações',
-  userFieldsMapping: [
-    { 
-      idField: 'target_user_id', 
-      nameField: 'avaliado_nome',
-      emailField: 'avaliado_email' 
-    },
-    { 
-      idField: 'evaluator_user_id', 
-      nameField: 'avaliador_nome' 
-    }
-  ]
-});
-
-// Características:
-// - Cache inteligente de 5 minutos por companyId
-// - Validação automática de tokens
-// - Resiliência: retorna entidades originais em caso de erro
-// - Suporta múltiplos campos de usuário por entidade`,c=`import { 
-  resolveFieldMappings, 
-  deriveNameField, 
-  deriveEmailField, 
-  deriveUsernameField 
-} from 'forlogic-core';
-
-// Derivar nome do campo de saída baseado no campo de ID
-deriveNameField('target_user_id');     // → 'target_user_name'
-deriveNameField('id_user');            // → 'id_user_name'
-deriveNameField('id_user', '_nome');   // → 'id_user_nome' (sufixo customizado)
-
-deriveEmailField('target_user_id');    // → 'target_user_email'
-deriveUsernameField('target_user_id'); // → 'target_user_username'
-
-// Resolver mapeamentos automaticamente
-// Prioridade: userFieldsMapping > userIdFields > default
-
-// Uso com lista simples de campos
-const mappings = resolveFieldMappings(['target_user_id', 'evaluator_user_id']);
-// Resultado:
-// [
-//   { idField: 'target_user_id', nameField: 'target_user_name', ... },
-//   { idField: 'evaluator_user_id', nameField: 'evaluator_user_name', ... }
-// ]
-
-// Uso com mapeamento explícito
-const mappings = resolveFieldMappings(undefined, [
-  { idField: 'id_user', nameField: 'responsible_name' }
-]);
-
-// Default (sem parâmetros): id_user → responsible_name
-const mappings = resolveFieldMappings();
-// [{ idField: 'id_user', nameField: 'responsible_name' }]`,u=[{name:"createService<T, TInsert, TUpdate>(options)",type:"CrudService<T>",default:"-",description:"Factory para criar serviço CRUD completo com Supabase. Implementa soft delete e RLS."},{name:"options.tableName",type:"string",default:"-",description:"Nome da tabela no Supabase."},{name:"options.schemaName",type:"string",default:"'common'",description:"Schema do banco de dados."},{name:"options.searchFields",type:"string[]",default:"[]",description:"Campos para busca textual (ilike)."},{name:"options.selectFields",type:"string",default:"'*'",description:'Campos para select, suporta joins (ex: "*, categories(name)").'},{name:"options.enableQualiexEnrichment",type:"boolean",default:"false",description:"Se deve enriquecer dados com informações do Qualiex."},{name:"emailService.sendEmail(params)",type:"Promise<any>",default:"-",description:"Envia email usando template do banco de dados via edge function."},{name:"params.templateCode",type:"string",default:"-",description:"Código do template em common.email_templates."},{name:"params.to",type:"string | string[]",default:"-",description:"Destinatário(s) do email."},{name:"params.variables",type:"Record<string, any>",default:"-",description:"Variáveis para substituição no template ({{variableName}})."},{name:"errorService.handleError(error, showToast?)",type:"void",default:"showToast: true",description:"Trata erro e exibe toast com título apropriado. Rate limiting: máx 3/min."},{name:"errorService.success(title, description?)",type:"void",default:"-",description:"Exibe toast de sucesso."},{name:"errorService.getErrors()",type:"ErrorEntry[]",default:"-",description:"Retorna os últimos 50 erros registrados."},{name:"QualiexEnrichmentService.enrichWithUserData(entities, options)",type:"Promise<T[]>",default:"-",description:"Enriquece entidades com dados de usuários do Qualiex (nome, email, username). Cache de 5 min."},{name:"options.entityName",type:"string",default:"-",description:"Nome da entidade para logs de debug."},{name:"options.userIdFields",type:"string[]",default:"-",description:"Lista de campos de ID de usuário para enriquecer."},{name:"options.userFieldsMapping",type:"QualiexUserFieldMapping[]",default:"-",description:"Mapeamento customizado de campos (prioridade sobre userIdFields)."},{name:"deriveNameField(idField, suffix?)",type:"string",default:"suffix: '_name'",description:"Deriva campo de nome a partir do ID (ex: target_user_id → target_user_name)."},{name:"deriveEmailField(idField, suffix?)",type:"string",default:"suffix: '_email'",description:"Deriva campo de email a partir do ID (ex: target_user_id → target_user_email)."},{name:"deriveUsernameField(idField, suffix?)",type:"string",default:"suffix: '_username'",description:"Deriva campo de username a partir do ID."},{name:"resolveFieldMappings(userIdFields?, userFieldsMapping?)",type:"QualiexUserFieldMapping[]",default:"-",description:"Resolve mapeamentos com prioridade: userFieldsMapping > userIdFields > default."}];function a({title:i,description:r,code:s}){return e.jsxs("div",{className:"space-y-3",children:[e.jsxs("div",{children:[e.jsx("h3",{className:"text-lg font-semibold",children:i}),e.jsx("p",{className:"text-sm text-muted-foreground",children:r})]}),e.jsx("pre",{className:"rounded-lg border bg-muted/50 p-4 overflow-x-auto",children:e.jsx("code",{className:"text-sm font-mono",children:s})})]})}function f(){const i=[{id:"exemplos",label:"Exemplos"},{id:"baseservice-createservice",label:"BaseService (createService)"},{id:"emailservice",label:"EmailService"},{id:"errorservice",label:"ErrorService"},{id:"qualiexenrichmentservice",label:"QualiexEnrichmentService"},{id:"qualiexenrichmentservice",label:"QualiexEnrichmentService"},{id:"qualiexfieldhelpers",label:"QualiexFieldHelpers"},{id:"tipos",label:"Tipos"}];return e.jsx(o,{title:"Services",description:"Serviços utilitários da biblioteca forlogic-core para operações CRUD, envio de emails, tratamento de erros e gerenciamento de traduções. Todos os serviços são singletons prontos para uso.",usage:t,props:u,tocItems:i,notes:["createService implementa soft delete automaticamente (is_removed = true).","createService valida token de autenticação antes de cada operação.","EmailService usa templates cadastrados em common.email_templates via edge function send-email.","ErrorService possui rate limiting: máximo 3 toasts por minuto para evitar spam.","createService suporta joins automáticos via selectFields.","QualiexEnrichmentService usa cache de 5 minutos por companyId para evitar chamadas desnecessárias.","QualiexEnrichmentService é resiliente: retorna entidades originais em caso de erro.",'QualiexFieldHelpers remove sufixo "_id" automaticamente antes de adicionar o novo sufixo.'],children:e.jsxs("div",{id:"exemplos",className:"space-y-8 scroll-mt-4",children:[e.jsx("h2",{className:"text-2xl font-semibold tracking-tight border-b pb-2",children:"Exemplos"}),e.jsx("div",{id:"baseservice-createservice",className:"scroll-mt-4",children:e.jsx(a,{title:"BaseService (createService)",description:"Factory para criar serviços CRUD completos com Supabase. Suporta paginação, busca, ordenação, filtros, joins e soft delete.",code:d})}),e.jsx("div",{id:"emailservice",className:"scroll-mt-4",children:e.jsx(a,{title:"EmailService",description:"Envia emails usando templates cadastrados no banco de dados. Suporta variáveis de substituição e múltiplos destinatários.",code:n})}),e.jsx("div",{id:"errorservice",className:"scroll-mt-4",children:e.jsx(a,{title:"ErrorService",description:"Tratamento centralizado de erros com toasts inteligentes e rate limiting. Mantém histórico dos últimos 50 erros.",code:l})}),e.jsx("div",{id:"qualiexenrichmentservice",className:"scroll-mt-4",children:e.jsx(a,{title:"QualiexEnrichmentService",description:"Enriquece entidades com dados de usuários do Qualiex (nome, email, username). Usa cache inteligente de 5 minutos por companyId.",code:m})}),e.jsx("div",{id:"qualiexfieldhelpers",className:"scroll-mt-4",children:e.jsx(a,{title:"QualiexFieldHelpers",description:"Utilitários para derivar automaticamente nomes de campos de saída baseado nos campos de ID de usuário.",code:c})}),e.jsx("div",{id:"tipos",className:"scroll-mt-4",children:e.jsx("h2",{className:"text-2xl font-semibold tracking-tight border-b pb-2",children:"Tipos"})}),e.jsxs("div",{className:"space-y-6",children:[e.jsxs("div",{className:"space-y-3",children:[e.jsx("h3",{className:"text-lg font-semibold",children:"QualiexUserFieldMapping"}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Define o mapeamento entre um campo de ID de usuário e seus campos de saída correspondentes (nome, email, username)."}),e.jsx("pre",{className:"rounded-lg border bg-muted/50 p-4 overflow-x-auto",children:e.jsx("code",{className:"text-sm font-mono",children:`interface QualiexUserFieldMapping {
-  /** Nome do campo de ID de usuário na entidade (ex: "target_user_id") */
-  idField: string;
-  
-  /** Nome do campo de saída para o nome (ex: "target_user_name") 
-   *  Default: idField + "_name" (remove "_id" se presente) */
-  nameField?: string;
-  
-  /** Nome do campo de saída para o email (ex: "target_user_email")
-   *  Default: idField + "_email" (remove "_id" se presente) */
-  emailField?: string;
-  
-  /** Nome do campo de saída para o username (ex: "target_user_username")
-   *  Default: idField + "_username" (remove "_id" se presente) */
-  usernameField?: string;
-}
-
-// Exemplos de uso:
-const mappings: QualiexUserFieldMapping[] = [
-  // Mapeamento simples (só nome)
-  { idField: 'id_user', nameField: 'responsible_name' },
-  
-  // Mapeamento completo
-  { 
-    idField: 'target_user_id', 
-    nameField: 'target_name',
-    emailField: 'target_email',
-    usernameField: 'target_username'
-  },
-  
-  // Mapeamento parcial (nome e email)
-  { 
-    idField: 'evaluator_user_id', 
-    nameField: 'evaluator_name',
-    emailField: 'evaluator_email'
-  }
-];`})})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx("h3",{className:"text-lg font-semibold",children:"QualiexEnrichmentConfig"}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Configuração global de sufixos padrão para derivação automática de campos. Usado internamente pelo QualiexFieldHelpers."}),e.jsx("pre",{className:"rounded-lg border bg-muted/50 p-4 overflow-x-auto",children:e.jsx("code",{className:"text-sm font-mono",children:`interface QualiexEnrichmentConfig {
-  /** Sufixo padrão para campos de nome (default: "_name") */
-  userNameFieldSuffix?: string;
-  
-  /** Sufixo padrão para campos de email (default: "_email") */
-  userEmailFieldSuffix?: string;
-  
-  /** Sufixo padrão para campos de username (default: "_username") */
-  userUsernameFieldSuffix?: string;
-}
-
-// Exemplo de configuração customizada:
-const config: QualiexEnrichmentConfig = {
-  userNameFieldSuffix: '_nome',     // target_user_id → target_user_nome
-  userEmailFieldSuffix: '_email',   // target_user_id → target_user_email
-  userUsernameFieldSuffix: '_login' // target_user_id → target_user_login
-};
-
-// Valores padrão:
-// - userNameFieldSuffix: '_name'
-// - userEmailFieldSuffix: '_email'  
-// - userUsernameFieldSuffix: '_username'`})})]}),e.jsxs("div",{className:"space-y-3",children:[e.jsx("h3",{className:"text-lg font-semibold",children:"QualiexUser"}),e.jsx("p",{className:"text-sm text-muted-foreground",children:"Representa um usuário do sistema Qualiex. Retornado pelo hook useQualiexUsers e usado internamente pelo QualiexEnrichmentService."}),e.jsx("pre",{className:"rounded-lg border bg-muted/50 p-4 overflow-x-auto",children:e.jsx("code",{className:"text-sm font-mono",children:`interface QualiexUser {
-  /** ID único do usuário (formato UUID) */
-  id?: string;
-  
-  /** ID alternativo do usuário (alguns endpoints retornam neste campo) */
-  userId?: string;
-  
-  /** Nome de usuário (login) */
-  userName?: string;
-  
-  /** Email do usuário */
-  userEmail?: string;
-  
-  /** Nome de exibição (nome completo) */
-  displayName?: string;
-  
-  /** ID do local/unidade do usuário */
-  placeId?: string | null;
-  
-  /** Nome do local/unidade do usuário */
-  placeName?: string | null;
-  
-  /** ID do cargo/função do usuário */
-  roleId?: string;
-  
-  /** Nome do cargo/função do usuário */
-  roleName?: string;
-  
-  /** ID da empresa do usuário */
-  companyId?: string;
-  
-  /** Nome da empresa do usuário */
-  companyName?: string;
-}
-
-// Exemplo de uso com useQualiexUsers:
-import { useQualiexUsers } from 'forlogic-core';
-
-function UserSelector() {
-  const { data: users, isLoading } = useQualiexUsers({ enabled: true });
-  
-  // users é QualiexUser[]
-  return (
-    <select>
-      {users?.map(user => (
-        <option key={user.id || user.userId} value={user.id || user.userId}>
-          {user.displayName || user.userName} ({user.userEmail})
-        </option>
-      ))}
-    </select>
-  );
-}
-
-// Nota: A API retorna apenas usuários ativos (filterStatus='active').
-// O campo isActive foi removido pois a API não o fornece.`})})]})]})]})})}export{f as ServicesDoc};