@bonnard/cli 0.2.10 → 0.2.12

package/dist/docs/topics/dashboards.queries.md

@@ -6,7 +6,7 @@
 
 Each query fetches data from your semantic layer and makes it available to chart components. Queries use the same measures and dimensions defined in your cubes and views — field names stay consistent whether you're querying from a dashboard, MCP, or the API.
 
-Query blocks have a unique name and map to a `QueryOptions` shape. Components reference them using `data={query_name}`. Field names are unqualified — use `count` not `orders.count` — because the `cube` property provides the context.
+Query blocks have a unique name and map to a `QueryOptions` shape. Components reference them using `data={query_name}`. All field names must be fully qualified with the cube or view name (e.g. `orders.count`, `orders.created_at`).
 
 ## Syntax
 
@@ -14,10 +14,9 @@ Query blocks use fenced code with the `query` language tag followed by a name:
 
 ````markdown
 ```query revenue_trend
-cube: orders
-measures: [total_revenue]
+measures: [orders.total_revenue]
 timeDimension:
-  dimension: created_at
+  dimension: orders.created_at
   granularity: month
   dateRange: [2025-01-01, 2025-12-31]
 ```
@@ -27,19 +26,18 @@ timeDimension:
 
 | Property | Type | Required | Description |
 |----------|------|----------|-------------|
-| `cube` | string | Yes | The cube or view to query (e.g. `orders`) |
-| `measures` | string[] | No | Measures to aggregate (e.g. `[count, total_revenue]`) |
-| `dimensions` | string[] | No | Dimensions to group by (e.g. `[status, city]`) |
+| `measures` | string[] | No | Fully qualified measures to aggregate (e.g. `[orders.count, orders.total_revenue]`) |
+| `dimensions` | string[] | No | Fully qualified dimensions to group by (e.g. `[orders.status, orders.city]`) |
 | `filters` | Filter[] | No | Row-level filters |
 | `timeDimension` | object | No | Time-based grouping and date range |
-| `orderBy` | object | No | Sort specification (e.g. `{total_revenue: desc}`) |
+| `orderBy` | object | No | Sort specification (e.g. `{orders.total_revenue: desc}`) |
 | `limit` | number | No | Maximum rows to return |
 
 ### timeDimension
 
 | Property | Type | Required | Description |
 |----------|------|----------|-------------|
-| `dimension` | string | Yes | Time dimension name (e.g. `created_at`) |
+| `dimension` | string | Yes | Fully qualified time dimension name (e.g. `orders.created_at`) |
 | `granularity` | string | No | `day`, `week`, `month`, `quarter`, or `year` |
 | `dateRange` | string[] | No | `[start, end]` in `YYYY-MM-DD` format |
 
@@ -59,8 +57,7 @@ Each filter is an object with:
 
 ````markdown
 ```query total_orders
-cube: orders
-measures: [count]
+measures: [orders.count]
 ```
 ````
 
@@ -68,11 +65,10 @@ measures: [count]
 
 ````markdown
 ```query revenue_by_city
-cube: orders
-measures: [total_revenue]
-dimensions: [city]
+measures: [orders.total_revenue]
+dimensions: [orders.city]
 orderBy:
-  total_revenue: desc
+  orders.total_revenue: desc
 limit: 10
 ```
 ````
@@ -81,10 +77,9 @@ limit: 10
 
 ````markdown
 ```query monthly_revenue
-cube: orders
-measures: [total_revenue]
+measures: [orders.total_revenue]
 timeDimension:
-  dimension: created_at
+  dimension: orders.created_at
   granularity: month
   dateRange: [2025-01-01, 2025-12-31]
 ```
@@ -94,11 +89,10 @@ timeDimension:
 
 ````markdown
 ```query completed_orders
-cube: orders
-measures: [count, total_revenue]
-dimensions: [category]
+measures: [orders.count, orders.total_revenue]
+dimensions: [orders.category]
 filters:
-  - dimension: status
+  - dimension: orders.status
     operator: equals
     values: [completed]
 ```
@@ -108,8 +102,7 @@ filters:
 
 - Query names must be valid identifiers (letters, numbers, `_`, `$`)
 - Query names must be unique within a dashboard
-- Every query must specify a `cube`
-- Field names are unqualified (use `count` not `orders.count`) — the `cube` provides the context
+- All field names must be fully qualified with the cube or view name (e.g. `orders.count`, not `count`)
 - Components reference queries by name: `data={query_name}`
 
 ## See Also

package/dist/docs/topics/querying.sdk.md

@@ -18,11 +18,10 @@ const bonnard = createClient({
 });
 
 const result = await bonnard.query({
-  cube: 'orders',
-  measures: ['revenue', 'count'],
-  dimensions: ['status'],
+  measures: ['orders.revenue', 'orders.count'],
+  dimensions: ['orders.status'],
   timeDimension: {
-    dimension: 'created_at',
+    dimension: 'orders.created_at',
     granularity: 'month',
     dateRange: ['2025-01-01', '2025-12-31'],
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonnard/cli",
-  "version": "0.2.10",
+  "version": "0.2.12",
   "type": "module",
   "bin": {
     "bon": "./dist/bin/bon.mjs"