@praxisui/charts 3.0.0-beta.6 → 3.0.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -127,6 +127,28 @@ No modo remoto, o componente:
127
127
  - transforma a resposta agregada em `PraxisChartDataRow[]`
128
128
  - renderiza o estado `loading`, `empty`, `error` ou `ready`
129
129
 
130
+ ## Declarative Query Contract
131
+
132
+ For dynamic pages and widget orchestration, the primary public input for remote chart queries is `queryContext`.
133
+
134
+ ```html
135
+ <praxis-chart
136
+ [config]="chartConfig"
137
+ [queryContext]="{
138
+ filters: { departmentId: 10, status: 'ACTIVE' },
139
+ sort: ['competencia,asc'],
140
+ limit: 12
141
+ }"
142
+ ></praxis-chart>
143
+ ```
144
+
145
+ Current rules:
146
+
147
+ - `queryContext.filters` is merged into remote datasource requests
148
+ - `queryContext.sort` and `queryContext.limit` are also propagated when the datasource path supports them
149
+ - `filterCriteria` is still accepted as a legacy compatibility bridge
150
+ - for new authoring, `DynamicPage` connections and examples, prefer `queryContext`
151
+
130
152
  ### Versão Pedagógica de Alto Nível
131
153
 
132
154
  Esta é a leitura adequada para documentação pública e landing pages.