@adminforth/dashboard 1.11.0 → 1.11.2

package/custom/skills/adminforth-dashboard/SKILL.md

@@ -476,6 +476,10 @@ query:
 
 Do not use bare query.steps without source: steps.
 Do not use metric. Use select even when a step has only one aggregate.
+All filters, including aggregate select item filters, must use filter expression shape.
+Use `filters: { field: model, eq: gpt-5.4 }`, not shorthand maps like `filters: { model: gpt-5.4 }`.
+When grouping by a derived date alias, repeat the source field object in `group_by`.
+Example: if `select` has `{ field: used_at, grain: day, as: day }`, use `group_by: [{ field: used_at, grain: day, as: day }]`, not `group_by: [day]`.
 
 ## Date range rules
 

package/custom/widgets/KpiCardWidget.vue

@@ -124,9 +124,9 @@ const label = computed(() => kpiConfig.value?.subtitle?.field
       .join(': ')
   : kpiConfig.value?.subtitle?.text ?? kpiConfig.value?.title ?? props.widget.label)
 const formattedValue = computed(() => `${kpiConfig.value?.value.prefix ?? ''}${formatValue(value.value, kpiConfig.value?.value.format)}${kpiConfig.value?.value.suffix ?? ''}`)
-const comparisonValue = computed(() => toFiniteNumber(kpiConfig.value?.comparison?.field
-  ? firstRow.value[kpiConfig.value.comparison.field]
-  : undefined))
+const comparisonValue = computed(() => kpiConfig.value?.comparison?.field
+  ? value.value - toFiniteNumber(firstRow.value[kpiConfig.value.comparison.field])
+  : 0)
 const comparison = computed(() => {
   const config = kpiConfig.value?.comparison
 

package/custom/widgets/chart/StackedBarChart.vue

@@ -120,7 +120,7 @@ const { el: rootEl, width: rootWidth } = useElementSize<HTMLDivElement>()
 const { el: svgEl, width: svgWidth, height: svgHeight } = useElementSize<HTMLDivElement>()
 
 const barGap = 10
-const seriesNames = computed(() => Array.from(new Set(props.rows.map((row) => formatChartLabel(row[props.seriesField])))))
+const seriesNames = computed(() => Array.from(new Set(props.rows.map((row) => formatSeriesLabel(row[props.seriesField])))))
 const normalizedSeries = computed(() => seriesNames.value.map((name, index) => ({
   name,
   color: props.colors?.[index] || CHART_COLORS[index % CHART_COLORS.length],
@@ -141,7 +141,7 @@ const groupedRows = computed(() => {
   for (const row of props.rows) {
     const label = formatChartLabel(row[props.xField])
     const item = grouped.get(label) ?? { [props.xField]: label }
-    const seriesName = formatChartLabel(row[props.seriesField])
+    const seriesName = formatSeriesLabel(row[props.seriesField])
 
     item[seriesName] = toFiniteNumber(item[seriesName]) + toFiniteNumber(row[props.yField])
 
@@ -240,4 +240,8 @@ function getBarTooltip(bar: { label: string, total: number, segments: Array<{ na
     ...segmentLines,
   ].join('\n')
 }
+
+function formatSeriesLabel(value: unknown) {
+  return typeof value === 'string' ? value : String(value)
+}
 </script>

package/dist/custom/skills/adminforth-dashboard/SKILL.md

@@ -476,6 +476,10 @@ query:
 
 Do not use bare query.steps without source: steps.
 Do not use metric. Use select even when a step has only one aggregate.
+All filters, including aggregate select item filters, must use filter expression shape.
+Use `filters: { field: model, eq: gpt-5.4 }`, not shorthand maps like `filters: { model: gpt-5.4 }`.
+When grouping by a derived date alias, repeat the source field object in `group_by`.
+Example: if `select` has `{ field: used_at, grain: day, as: day }`, use `group_by: [{ field: used_at, grain: day, as: day }]`, not `group_by: [day]`.
 
 ## Date range rules
 

package/dist/custom/widgets/KpiCardWidget.vue

@@ -124,9 +124,9 @@ const label = computed(() => kpiConfig.value?.subtitle?.field
       .join(': ')
   : kpiConfig.value?.subtitle?.text ?? kpiConfig.value?.title ?? props.widget.label)
 const formattedValue = computed(() => `${kpiConfig.value?.value.prefix ?? ''}${formatValue(value.value, kpiConfig.value?.value.format)}${kpiConfig.value?.value.suffix ?? ''}`)
-const comparisonValue = computed(() => toFiniteNumber(kpiConfig.value?.comparison?.field
-  ? firstRow.value[kpiConfig.value.comparison.field]
-  : undefined))
+const comparisonValue = computed(() => kpiConfig.value?.comparison?.field
+  ? value.value - toFiniteNumber(firstRow.value[kpiConfig.value.comparison.field])
+  : 0)
 const comparison = computed(() => {
   const config = kpiConfig.value?.comparison
 

package/dist/custom/widgets/chart/StackedBarChart.vue

@@ -120,7 +120,7 @@ const { el: rootEl, width: rootWidth } = useElementSize<HTMLDivElement>()
 const { el: svgEl, width: svgWidth, height: svgHeight } = useElementSize<HTMLDivElement>()
 
 const barGap = 10
-const seriesNames = computed(() => Array.from(new Set(props.rows.map((row) => formatChartLabel(row[props.seriesField])))))
+const seriesNames = computed(() => Array.from(new Set(props.rows.map((row) => formatSeriesLabel(row[props.seriesField])))))
 const normalizedSeries = computed(() => seriesNames.value.map((name, index) => ({
   name,
   color: props.colors?.[index] || CHART_COLORS[index % CHART_COLORS.length],
@@ -141,7 +141,7 @@ const groupedRows = computed(() => {
   for (const row of props.rows) {
     const label = formatChartLabel(row[props.xField])
     const item = grouped.get(label) ?? { [props.xField]: label }
-    const seriesName = formatChartLabel(row[props.seriesField])
+    const seriesName = formatSeriesLabel(row[props.seriesField])
 
     item[seriesName] = toFiniteNumber(item[seriesName]) + toFiniteNumber(row[props.yField])
 
@@ -240,4 +240,8 @@ function getBarTooltip(bar: { label: string, total: number, segments: Array<{ na
     ...segmentLines,
   ].join('\n')
 }
+
+function formatSeriesLabel(value: unknown) {
+  return typeof value === 'string' ? value : String(value)
+}
 </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adminforth/dashboard",
-  "version": "1.11.0",
+  "version": "1.11.2",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",