@wibi-global/sdk 0.1.1 → 0.1.3

package/dist/sdk/src/data/serialization/dashboard-serialization.types.ts

@@ -66,15 +66,17 @@ export interface SerializedLayout {
   sections: SerializedSection[]
 }
 
-export type SerializedWidgetType =
-  | 'kpi'
-  | 'chart'
-  | 'grid'
-  | 'progress-list'
-  | 'gauge'
-  | 'funnel'
-  | 'waterfall'
-  | 'heatmap'
+export type SerializedWidgetType =
+  | 'kpi'
+  | 'chart'
+  | 'grid'
+  | 'pivot'
+  | 'pivotgrid'
+  | 'progress-list'
+  | 'gauge'
+  | 'funnel'
+  | 'waterfall'
+  | 'heatmap'
   | 'scatter'
   | 'treemap'
   | 'sankey'
@@ -154,6 +156,10 @@ export interface SerializedChartProperties {
   bar_width?: number
   /** Rotacionar labels do eixo X em 45° */
   rotate_labels?: boolean
+  /** Rotacionar labels do eixo X em graus */
+  x_axis_label_rotate?: number
+  /** Formato textual de datas no eixo X */
+  x_axis_date_format?: string
   /** Habilitar zoom interativo */
   enable_zoom?: boolean
 
@@ -226,11 +232,11 @@ export interface SerializedGridColumnDef {
   format?: SerializedGridColumnFormat
 }
 
-export interface SerializedGridProperties {
-  title: string
-  page_size: number
-  columns: string[]
-  column_labels: Record<string, string>
+export interface SerializedGridProperties {
+  title: string
+  page_size: number
+  columns: string[]
+  column_labels: Record<string, string>
   enable_filters: boolean
   enable_export: boolean
   enable_pagination: boolean
@@ -245,41 +251,162 @@ export interface SerializedGridProperties {
   use_grid_v2?: boolean
   /** Mensagem quando não há dados */
   empty_message?: string
-  /** Mensagem durante carregamento */
-  loading_message?: string
-}
-
-export interface SerializedPanelAction {
-  path: string
-  title: string
-  description: string
-}
+  /** Mensagem durante carregamento */
+  loading_message?: string
+}
+
+export interface SerializedPivotProperties {
+  /** Campo das linhas da tabela pivot (snake_case) */
+  row_field?: string
+  /** Alias em camelCase (compatibilidade) */
+  rowField?: string
+
+  /** Campo das colunas da tabela pivot (snake_case) */
+  col_field?: string
+  /** Alias alternativo (compatibilidade) */
+  column_field?: string
+  /** Alias em camelCase (compatibilidade) */
+  colField?: string
+  /** Alias em camelCase (compatibilidade) */
+  columnField?: string
+
+  /** Campo numerico com o valor a agregar (snake_case) */
+  value_field?: string
+  /** Alias em camelCase (compatibilidade) */
+  valueField?: string
+
+  /** Agregacao: sum | avg | count | min | max (padrao: sum) */
+  aggregation?: 'sum' | 'avg' | 'count' | 'min' | 'max'
+
+  /** Mostrar linha/coluna de totais */
+  show_totals?: boolean
+  /** Alias em camelCase (compatibilidade) */
+  showTotals?: boolean
+
+  /** Formato do valor: number | currency | percent */
+  format?: 'number' | 'currency' | 'percent'
+  /** Alias legado (compatibilidade) */
+  value_format?: 'number' | 'currency' | 'percent'
+  /** Alias legado em camelCase (compatibilidade) */
+  valueFormat?: 'number' | 'currency' | 'percent'
+
+  /** Numero de casas decimais */
+  decimals?: number
+
+  /** Moeda quando format='currency' */
+  currency?: string
+
+  /** Locale (padrao pt-BR) */
+  locale?: string
+
+  /** Habilita busca no pivotgrid (compatibilidade; pode ser ignorado pelo renderer) */
+  searchable?: boolean
+  /** Placeholder da busca (compatibilidade) */
+  search_placeholder?: string
+  /** Placeholder da busca (compatibilidade) */
+  searchPlaceholder?: string
+
+  /** Mensagem durante carregamento (compatibilidade) */
+  loading_message?: string
+  /** Mensagem durante carregamento (compatibilidade) */
+  loadingMessage?: string
+
+  /** Mensagem quando nao ha dados (compatibilidade) */
+  empty_message?: string
+  /** Mensagem quando nao ha dados (compatibilidade) */
+  emptyMessage?: string
+}
+
+export interface SerializedPivotGridProperties extends SerializedPivotProperties {
+  /**
+   * PivotGrid e um widget serializado separado da pivot tradicional.
+   * No contrato atual, herda as mesmas propriedades base da pivot.
+   */
+}
+
+export interface SerializedPanelAction {
+  path: string
+  title: string
+  description: string
+}
 
 export interface SerializedProgressListProperties {
   /** Campo de label (categoria/nome exibido na linha) */
   labelField: string
+  /** Alias legado em snake_case */
+  label_field?: string
   /** Campo de valor numérico para as barras */
   valueField: string
+  /** Alias legado em snake_case */
+  value_field?: string
   /** Agregação: sum | avg | count | min | max */
   aggregation?: 'sum' | 'avg' | 'count' | 'min' | 'max'
   /** Número máximo de itens exibidos */
   maxItems?: number
+  /** Alias legado em snake_case */
+  max_items?: number
   /** Exibir valor numérico ao lado da barra */
   showValues?: boolean
+  /** Alias legado em snake_case */
+  show_values?: boolean
   /** Exibir percentual ao lado da barra */
   showPercentage?: boolean
+  /** Alias legado em snake_case */
+  show_percentage?: boolean
   /** Formato do valor: number | currency | compact | percentage */
   valueFormat?: 'number' | 'currency' | 'compact' | 'percentage'
+  /** Alias legado em snake_case */
+  value_format?: 'number' | 'currency' | 'compact' | 'percentage'
   /** Altura em px das barras de progresso */
   barHeight?: number
+  /** Alias legado em snake_case */
+  bar_height?: number
   /** Esquema de cores: gradient | single | custom */
   colorScheme?: 'gradient' | 'single' | 'custom'
+  /** Alias legado em snake_case */
+  color_scheme?: 'gradient' | 'single' | 'custom'
   /** Cor primária (usada em colorScheme='single') */
   primaryColor?: string
+  /** Alias legado em snake_case */
+  primary_color?: string
   /** Ordenação: value | label | none */
   sortBy?: 'value' | 'label' | 'none'
+  /** Alias legado em snake_case */
+  sort_by?: 'value' | 'label' | 'none'
   /** Direção da ordenação: asc | desc */
   sortOrder?: 'asc' | 'desc'
+  /** Alias legado em snake_case */
+  sort_order?: 'asc' | 'desc'
+  /** Alguns dashboards antigos incluem um title redundante nas properties */
+  title?: string
+  /** Exibir os filtros internos do componente (padrão: true quando filter1/filter2 definidos) */
+  showInternalFilters?: boolean
+  /** Filtro interno 1 — select discreto com query própria para popular as opções */
+  filter1?: {
+    /** Label do select (ex: "Filial", "Vendedor") */
+    label?: string
+    /** SQL para popular as opções; suporta ${startDate}, ${endDate}, ${empresaId}, ${companyFilter} */
+    sql: string
+    /** Campo do resultado SQL que será o valor da opção */
+    valueField: string
+    /** Campo do resultado SQL que será o label da opção (padrão: valueField) */
+    labelField?: string
+    /** Campo nos dados principais (rawData) pelo qual o filtro será aplicado */
+    filterField: string
+  }
+  /** Filtro interno 2 — select discreto com query própria para popular as opções */
+  filter2?: {
+    /** Label do select (ex: "Filial", "Vendedor") */
+    label?: string
+    /** SQL para popular as opções; suporta ${startDate}, ${endDate}, ${empresaId}, ${companyFilter} */
+    sql: string
+    /** Campo do resultado SQL que será o valor da opção */
+    valueField: string
+    /** Campo do resultado SQL que será o label da opção (padrão: valueField) */
+    labelField?: string
+    /** Campo nos dados principais (rawData) pelo qual o filtro será aplicado */
+    filterField: string
+  }
 }
 
 export interface SerializedPanelProperties {
@@ -379,15 +506,17 @@ export interface SerializedSpacerProperties {
   height: number
 }
 
-export type SerializedWidgetProperties =
-  | SerializedKpiProperties
-  | SerializedChartProperties
-  | SerializedGridProperties
-  | SerializedProgressListProperties
-  | SerializedPanelProperties
-  | SerializedDateWidgetProperties
-  | SerializedCompaniesWidgetProperties
-  | SerializedHeadingProperties
+export type SerializedWidgetProperties =
+  | SerializedKpiProperties
+  | SerializedChartProperties
+  | SerializedGridProperties
+  | SerializedPivotProperties
+  | SerializedPivotGridProperties
+  | SerializedProgressListProperties
+  | SerializedPanelProperties
+  | SerializedDateWidgetProperties
+  | SerializedCompaniesWidgetProperties
+  | SerializedHeadingProperties
   | SerializedTextProperties
   | SerializedImageProperties
   | SerializedDividerProperties

package/dist/sdk/src/data/serialization/index.d.ts

@@ -1,2 +1,2 @@
-export type { SerializedDashboard, SerializedMetadata, SerializedFilter, SerializedDateFilter, SerializedEmpresaFilter, SerializedLayout, SerializedSection, SerializedWidget, SerializedWidgetType, SerializedWidgetProperties, SerializedKpiProperties, SerializedChartProperties, SerializedGridProperties, SerializedProgressListProperties, SerializedPanelProperties, SerializedPanelAction, SerializedDateWidgetProperties, SerializedCompaniesWidgetProperties, SerializedGridColumnDef, SerializedGridColumnFormat, SerializedHeadingProperties, SerializedTextProperties, SerializedImageProperties, SerializedDividerProperties, SerializedSpacerProperties, SerializedQuery, DatePeriodType, } from './dashboard-serialization.types.js';
+export type { SerializedDashboard, SerializedMetadata, SerializedFilter, SerializedDateFilter, SerializedEmpresaFilter, SerializedLayout, SerializedSection, SerializedWidget, SerializedWidgetType, SerializedWidgetProperties, SerializedKpiProperties, SerializedChartProperties, SerializedGridProperties, SerializedPivotProperties, SerializedPivotGridProperties, SerializedProgressListProperties, SerializedPanelProperties, SerializedPanelAction, SerializedDateWidgetProperties, SerializedCompaniesWidgetProperties, SerializedGridColumnDef, SerializedGridColumnFormat, SerializedHeadingProperties, SerializedTextProperties, SerializedImageProperties, SerializedDividerProperties, SerializedSpacerProperties, SerializedQuery, DatePeriodType, } from './dashboard-serialization.types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/data/serialization/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/data/serialization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,mCAAmC,EACnC,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,eAAe,EACf,cAAc,GACf,MAAM,oCAAoC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/data/serialization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,6BAA6B,EAC7B,gCAAgC,EAChC,yBAAyB,EACzB,qBAAqB,EACrB,8BAA8B,EAC9B,mCAAmC,EACnC,uBAAuB,EACvB,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,eAAe,EACf,cAAc,GACf,MAAM,oCAAoC,CAAA"}

package/dist/sdk/src/data/widgets.wbx

@@ -102,7 +102,7 @@
             "donut_proporcao": "widget_type='chart' com chart_type='pie' e inner_radius > 0",
             "ranking_com_barra": "widget_type='progress-list' — top N itens com barra proporcional",
             "tabela_de_dados": "widget_type='grid' — tabela paginável com formatação por coluna",
-            "tabela_cruzada": "widget_type='pivot' — linhas × colunas com valor agregado",
+            "tabela_cruzada": "widget_type='pivotgrid' — linhas × colunas com valor agregado",
             "velocimetro_meta": "widget_type='gauge' — medidor circular com escala",
             "funil_conversao": "widget_type='funnel' — etapas de pipeline decrescentes",
             "cascata_contribuicao": "widget_type='waterfall' — parcelas positivas/negativas para um total",
@@ -137,7 +137,8 @@
             "multi-card": 160,
             "chart": 400,
             "grid": 350,
-            "pivot": 380,
+            "pivot": 380,
+            "pivotgrid": 380,
             "progress-list": 350,
             "gauge": 320,
             "funnel": 350,
@@ -1101,7 +1102,7 @@
         "fields": {
             "id": { "type": "string", "required": true },
             "type": { "type": "string", "required": true, "values": [
-                "chart", "grid", "table", "card", "filter", "text", "image", "line", "pie", "gauge", "pivot", "map",
+                "chart", "grid", "table", "card", "filter", "text", "image", "line", "pie", "gauge", "pivot", "pivotgrid", "map",
                 "area", "scatter", "treemap", "multi-card", "kpi", "sparkline", "funnel", "waterfall",
                 "filled-map", "dropdown", "timeline", "group",
                 "radar", "heatmap", "candlestick", "boxplot", "sankey", "graph", "sunburst", "tree",
@@ -1694,11 +1695,11 @@
             },
             "llm_instruction": "Para grids no dashboard.serialized.json, SEMPRE prefira use_grid_v2: true com column_defs quando souber os campos antecipadamente. O DataGridV2 é mais leve, suporta formatação por coluna (currency, percentage, date, etc.), resize e reorder de colunas nativo. Se não souber os campos, use o modo legado (columns + column_labels) que auto-detecta."
         },
-        "pivot": {
-            "name": "Pivot",
-            "category": "data",
-            "description": "Tabela pivot (dinâmica) para análise cruzada — linhas × colunas com valores agregados.",
-            "icon": "📋",
+        "pivot": {
+            "name": "Pivot",
+            "category": "data",
+            "description": "Tabela pivot (dinâmica) para análise cruzada — linhas × colunas com valores agregados.",
+            "icon": "📋",
             "render": "PivotComponent",
             "defaultSize": { "width": 980, "height": 400 },
             "llm_instruction": "Use widget_type='pivot' para tabela cruzada (ex: vendas por vendedor × mês). OBRIGATÓRIO: row_field (dimensão das linhas), col_field (dimensão das colunas), value_field (métrica). Aggregation padrão: sum.",
@@ -1707,10 +1708,30 @@
                 "col_field": { "type": "string", "required": true, "description": "Campo das colunas da tabela pivot. Ex: 'mes', 'ano', 'categoria'." },
                 "value_field": { "type": "string", "required": true, "description": "Campo numérico com o valor a agregar." },
                 "aggregation": { "type": "string", "required": false, "default": "sum", "values": ["sum", "avg", "count", "min", "max"] },
-                "show_totals": { "type": "boolean", "required": false, "default": true, "description": "Mostrar linha/coluna de totais." },
-                "format": { "type": "string", "required": false, "values": ["number", "currency", "percent"], "default": "number" }
-            }
-        },
+                "show_totals": { "type": "boolean", "required": false, "default": true, "description": "Mostrar linha/coluna de totais." },
+                "format": { "type": "string", "required": false, "values": ["number", "currency", "percent"], "default": "number" }
+            }
+        },
+        "pivotgrid": {
+            "name": "PivotGrid",
+            "category": "data",
+            "description": "Tabela pivot com visual inspirado em DataGridV2, com busca, totais e formatação.",
+            "icon": "📋",
+            "render": "PivotGrid",
+            "defaultSize": { "width": 980, "height": 400 },
+            "llm_instruction": "Use widget_type='pivotgrid' para tabela cruzada moderna (ex: vendas por vendedor × mês) quando quiser uma pivot com visual mais próximo de DataGridV2. OBRIGATÓRIO: row_field, col_field e value_field. Opcional: aggregation, show_totals e format.",
+            "propertiesDetailed": {
+                "row_field": { "type": "string", "required": true, "description": "Campo das linhas da tabela pivot." },
+                "col_field": { "type": "string", "required": true, "description": "Campo das colunas da tabela pivot." },
+                "value_field": { "type": "string", "required": true, "description": "Campo numérico com o valor a agregar." },
+                "aggregation": { "type": "string", "required": false, "default": "sum", "values": ["sum", "avg", "count", "min", "max"] },
+                "show_totals": { "type": "boolean", "required": false, "default": true, "description": "Mostrar linha/coluna de totais." },
+                "format": { "type": "string", "required": false, "values": ["number", "currency", "percent"], "default": "number" },
+                "searchable": { "type": "boolean", "required": false, "default": true },
+                "loading_message": { "type": "string", "required": false, "default": "Carregando..." },
+                "empty_message": { "type": "string", "required": false, "default": "Nenhum dado encontrado." }
+            }
+        },
         "sparkline": {
             "name": "Sparkline",
             "category": "data",
@@ -1825,11 +1846,11 @@
         "progress-list": {
             "name": "Lista de Progresso",
             "category": "data",
-            "description": "Lista com barras de progresso, valores e percentuais. Exibe rankings de itens (top clientes, produtos, fornecedores, etc.) com barra proporcional ao valor.",
+            "description": "Lista com barras de progresso, valores e percentuais. Exibe rankings de itens (top clientes, produtos, fornecedores, etc.) com barra proporcional ao valor. Suporta até 2 filtros dropdown internos para segmentação interativa dos dados.",
             "icon": "📊",
             "render": "ProgressListComponent",
             "defaultSize": { "width": 480, "height": 400 },
-            "llm_instruction": "Use widget_type='progress-list' para rankings com barra de progresso (ex: top clientes, top produtos, top cidades). OBRIGATÓRIO definir labelField (nome da categoria) e valueField (campo numérico). Os dados vêm da query SQL via query_id. NÃO use widget_type='kpi' ou 'panel' para este caso. Exemplo: { \"widget_type\": \"progress-list\", \"properties\": { \"labelField\": \"nomeFornecedor\", \"valueField\": \"valorTotal\", \"maxItems\": 10, \"valueFormat\": \"currency\", \"colorScheme\": \"gradient\" } }. IMPORTANTE: labelField e valueField devem corresponder EXATAMENTE aos aliases camelCase da query SQL.",
+            "llm_instruction": "Use widget_type='progress-list' para rankings com barra de progresso (ex: top clientes, top produtos, top cidades). OBRIGATÓRIO definir labelField (nome da categoria) e valueField (campo numérico). Os dados vêm da query SQL via query_id. NÃO use widget_type='kpi' ou 'panel' para este caso.\n\nEXEMPLO BÁSICO:\n{ \"widget_type\": \"progress-list\", \"properties\": { \"labelField\": \"nomeFornecedor\", \"valueField\": \"valorTotal\", \"maxItems\": 10, \"valueFormat\": \"currency\", \"colorScheme\": \"gradient\" } }\n\nFILTROS INTERNOS (filter1 / filter2): Use para adicionar selects discretos dentro do widget que filtram os dados localmente (client-side) sem nova query ao banco. Cada filtro tem: sql (query para popular as opções), valueField (campo valor da opção), labelField (campo label da opção, padrão=valueField), filterField (campo nos dados principais a filtrar), label (texto do select).\n\nVARIÁVEIS NAS SQLs DE FILTRO: As mesmas variáveis da query principal estão disponíveis: ${startDate}, ${endDate}, ${empresaId}, ${companyFilter:alias}.\n\nEXEMPLO COM FILTROS:\n{ \"widget_type\": \"progress-list\", \"properties\": { \"labelField\": \"nomeCliente\", \"valueField\": \"valorVendas\", \"maxItems\": 15, \"valueFormat\": \"currency\", \"showInternalFilters\": true, \"filter1\": { \"label\": \"Filial\", \"sql\": \"SELECT filialId AS value, nomeFilial AS label FROM vw_filiais WHERE empresaId = ${empresaId} ORDER BY nomeFilial\", \"valueField\": \"value\", \"labelField\": \"label\", \"filterField\": \"filialId\" }, \"filter2\": { \"label\": \"Vendedor\", \"sql\": \"SELECT vendedorId AS value, nomeVendedor AS label FROM vw_vendedores WHERE empresaId = ${empresaId} ORDER BY nomeVendedor\", \"valueField\": \"value\", \"labelField\": \"label\", \"filterField\": \"vendedorId\" } } }\n\nIMPORTANTE: labelField, valueField e filterField devem corresponder EXATAMENTE aos aliases camelCase da query SQL. Quando filter1 ou filter2 estão definidos, showInternalFilters pode ser omitido (padrão true) ou definido como false para ocultar os filtros.",
             "properties": [
                 "labelField",
                 "valueField",
@@ -1842,8 +1863,50 @@
                 "colorScheme",
                 "primaryColor",
                 "sortBy",
-                "sortOrder"
-            ]
+                "sortOrder",
+                "showInternalFilters",
+                "filter1",
+                "filter2"
+            ],
+            "propertiesDetailed": {
+                "labelField": { "type": "string", "required": true, "description": "Campo da categoria/nome exibido em cada linha. Deve ser alias camelCase da query." },
+                "valueField": { "type": "string", "required": true, "description": "Campo numérico para as barras de progresso. Deve ser alias camelCase da query." },
+                "aggregation": { "type": "string", "required": false, "values": ["sum", "avg", "count", "min", "max"], "default": "sum" },
+                "maxItems": { "type": "number", "required": false, "default": 10, "description": "Número máximo de itens exibidos." },
+                "showValues": { "type": "boolean", "required": false, "default": true, "description": "Exibir valor numérico ao lado da barra." },
+                "showPercentage": { "type": "boolean", "required": false, "default": false, "description": "Exibir percentual ao lado da barra." },
+                "valueFormat": { "type": "string", "required": false, "values": ["number", "currency", "compact", "percentage"], "default": "number" },
+                "barHeight": { "type": "number", "required": false, "default": 8, "description": "Altura em px das barras de progresso." },
+                "colorScheme": { "type": "string", "required": false, "values": ["gradient", "single", "custom"], "default": "gradient" },
+                "primaryColor": { "type": "string", "required": false, "description": "Cor primária em hex (usado quando colorScheme='single')." },
+                "sortBy": { "type": "string", "required": false, "values": ["value", "label", "none"], "default": "value" },
+                "sortOrder": { "type": "string", "required": false, "values": ["asc", "desc"], "default": "desc" },
+                "showInternalFilters": { "type": "boolean", "required": false, "default": true, "description": "Exibir os selects de filtro interno. Padrão true quando filter1 ou filter2 estão definidos." },
+                "filter1": {
+                    "type": "object",
+                    "required": false,
+                    "description": "Filtro dropdown interno 1. Popula opções via SQL e filtra dados localmente.",
+                    "fields": {
+                        "label": { "type": "string", "required": false, "description": "Texto do label do select (ex: 'Filial', 'Vendedor')." },
+                        "sql": { "type": "string", "required": true, "description": "SQL para popular as opções. Suporta ${startDate}, ${endDate}, ${empresaId}, ${companyFilter:alias}." },
+                        "valueField": { "type": "string", "required": true, "description": "Campo do resultado SQL que será o valor da opção (deve ser alias camelCase)." },
+                        "labelField": { "type": "string", "required": false, "description": "Campo do resultado SQL que será o texto da opção (padrão: igual a valueField)." },
+                        "filterField": { "type": "string", "required": true, "description": "Campo nos dados principais (rawData) pelo qual o filtro será aplicado (deve ser alias camelCase)." }
+                    }
+                },
+                "filter2": {
+                    "type": "object",
+                    "required": false,
+                    "description": "Filtro dropdown interno 2. Popula opções via SQL e filtra dados localmente.",
+                    "fields": {
+                        "label": { "type": "string", "required": false, "description": "Texto do label do select (ex: 'Filial', 'Vendedor')." },
+                        "sql": { "type": "string", "required": true, "description": "SQL para popular as opções. Suporta ${startDate}, ${endDate}, ${empresaId}, ${companyFilter:alias}." },
+                        "valueField": { "type": "string", "required": true, "description": "Campo do resultado SQL que será o valor da opção (deve ser alias camelCase)." },
+                        "labelField": { "type": "string", "required": false, "description": "Campo do resultado SQL que será o texto da opção (padrão: igual a valueField)." },
+                        "filterField": { "type": "string", "required": true, "description": "Campo nos dados principais (rawData) pelo qual o filtro será aplicado (deve ser alias camelCase)." }
+                    }
+                }
+            }
         },
         "treemap": {
             "name": "Treemap",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wibi-global/sdk",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "main": "dist/sdk/src/index.js",
   "types": "dist/sdk/src/index.d.ts",
@@ -26,7 +26,7 @@
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\""
   },
   "dependencies": {
-    "@wibi-global/artifact-schema": "0.1.1"
+    "@wibi-global/artifact-schema": "0.1.3"
   },
   "publishConfig": {
     "access": "public"