@graphenedata/cli 0.0.17 → 0.0.18

package/dist/cli/cli.js

@@ -20,12 +20,12 @@ import {
   runServeInBackground,
   stopGrapheneIfRunning,
   toSql
-} from "./chunk-TZTTALAV.js";
+} from "./chunk-UTV3ERGI.js";
 import {
   config,
   loadConfig,
   setGlobalConfig
-} from "./chunk-56K2FF57.js";
+} from "./chunk-SQVXTHE5.js";
 
 // cli.ts
 import { Command } from "commander";
@@ -193,7 +193,7 @@ program.command("serve").description("Run the local server").option("--bg", "Run
       await runServeInBackground();
       return exit(0);
     } else {
-      let mod = await import("./serve2-S2LL4D4D.js");
+      let mod = await import("./serve2-CGQSM7TD.js");
       await mod.serve2(telemetry);
     }
   })

package/dist/cli/{duckdb-TKVMONRK.js → duckdb-V6PJEA7H.js}

@@ -1,6 +1,6 @@
 import {
   config
-} from "./chunk-56K2FF57.js";
+} from "./chunk-SQVXTHE5.js";
 
 // connections/duckdb.ts
 import { DuckDBTimestampValue, DuckDBInstance, DuckDBDateValue, DuckDBDecimalValue } from "@duckdb/node-api";
@@ -84,4 +84,4 @@ var DuckDBConnection = class {
 export {
   DuckDBConnection
 };
-//# sourceMappingURL=duckdb-TKVMONRK.js.map
+//# sourceMappingURL=duckdb-V6PJEA7H.js.map

package/dist/cli/{serve2-S2LL4D4D.js → serve2-CGQSM7TD.js}

@@ -6,10 +6,10 @@ import {
   runQuery,
   runVitePlugin,
   toSql
-} from "./chunk-TZTTALAV.js";
+} from "./chunk-UTV3ERGI.js";
 import {
   config
-} from "./chunk-56K2FF57.js";
+} from "./chunk-SQVXTHE5.js";
 
 // serve2.ts
 import { svelte, vitePreprocess } from "@sveltejs/vite-plugin-svelte";
@@ -445,4 +445,4 @@ export {
   serve2,
   svelteWarnings
 };
-//# sourceMappingURL=serve2-S2LL4D4D.js.map
+//# sourceMappingURL=serve2-CGQSM7TD.js.map

package/dist/cli/{snowflake-3VPDEYYP.js → snowflake-HVSTYBLB.js}

@@ -1,6 +1,6 @@
 import {
   config
-} from "./chunk-56K2FF57.js";
+} from "./chunk-SQVXTHE5.js";
 
 // connections/snowflake.ts
 import { createPrivateKey } from "node:crypto";
@@ -125,4 +125,4 @@ function snowflakeIdent(value) {
 export {
   SnowflakeConnection
 };
-//# sourceMappingURL=snowflake-3VPDEYYP.js.map
+//# sourceMappingURL=snowflake-HVSTYBLB.js.map

package/dist/index.d.ts

@@ -16,14 +16,14 @@ export type Field = {
 }
 
 // Metadata attached to fields.
-// There are a few built-in ones that Graphene already uses, but you can always attach your own metadata:
-// `price: cogs * 1.15 #ratio #format="US Dollar"` -> {ratio: true, format: 'US Dollar'}
+// Graphene validates user-authored metadata annotations, while inferred metadata may add internal keys.
+// `price: cogs * 1.15 #ratio #currency=USD` -> {ratio: true, currency: 'USD'}
 export type FieldMeta = {
   ratio?: true // 0 to 1 value
   pct?: true // 0 to 100 value
-  units?: string
+  currency?: string // ISO 4217 currency code
+  unit?: string // physical unit label
   timeGrain?: TimeGrain // resolution when the field is a date or timestamp
-  timePart?: string // extracted temporal part, normalized across backend spellings
   timeOrdinal?: TimeOrdinal // if the value represents something special like day_of_week, week_of_year, etc
   defaultName?: string // preferred output column name when an expression is selected without an alias
   [key: string]: string | true | undefined

package/dist/lang/index.d.ts

@@ -16,14 +16,14 @@ export type Field = {
 }
 
 // Metadata attached to fields.
-// There are a few built-in ones that Graphene already uses, but you can always attach your own metadata:
-// `price: cogs * 1.15 #ratio #format="US Dollar"` -> {ratio: true, format: 'US Dollar'}
+// Graphene validates user-authored metadata annotations, while inferred metadata may add internal keys.
+// `price: cogs * 1.15 #ratio #currency=USD` -> {ratio: true, currency: 'USD'}
 export type FieldMeta = {
   ratio?: true // 0 to 1 value
   pct?: true // 0 to 100 value
-  units?: string
+  currency?: string // ISO 4217 currency code
+  unit?: string // physical unit label
   timeGrain?: TimeGrain // resolution when the field is a date or timestamp
-  timePart?: string // extracted temporal part, normalized across backend spellings
   timeOrdinal?: TimeOrdinal // if the value represents something special like day_of_week, week_of_year, etc
   defaultName?: string // preferred output column name when an expression is selected without an alias
   [key: string]: string | true | undefined

package/dist/skills/graphene/SKILL.md

@@ -14,12 +14,12 @@ table orders (
   id bigint
   created_at datetime
   user_id bigint
-  amount float                          #units=usd
+  amount float                          #currency=USD
   status string
   join one users on user_id = users.id  -- many orders per user
   is_complete: status = 'Complete'      -- dimension (scalar expression)
-  revenue: sum(amount)                  -- measure (agg expression) #units=usd
-  avg_order: revenue / count(*)         -- measures can compose #units=usd
+  revenue: sum(amount)                  -- measure (agg expression) #currency=USD
+  avg_order: revenue / count(*)         -- measures can compose #currency=USD
 )
 table users (
   id bigint

package/dist/skills/graphene/references/gsql.md

@@ -17,8 +17,8 @@ table orders (
   user_id BIGINT
   created_at DATETIME
   status STRING -- One of 'Processing', 'Shipped', 'Complete', 'Cancelled', 'Returned'
-  amount FLOAT -- Amount paid by customer #units=usd
-  cost FLOAT -- Cost of materials #units=usd
+  amount FLOAT -- Amount paid by customer #currency=USD
+  cost FLOAT -- Cost of materials #currency=USD
 
   -- Join relationships
 
@@ -30,9 +30,9 @@ table orders (
   
   -- Measures
   
-  revenue: sum(case when revenue_recognized then amount else 0 end) #units=usd
-  cogs: sum(case when revenue_recognized then cost else 0 end) #units=usd
-  profit: revenue - cogs #units=usd
+  revenue: sum(case when revenue_recognized then amount else 0 end) #currency=USD
+  cogs: sum(case when revenue_recognized then cost else 0 end) #currency=USD
+  profit: revenue - cogs #currency=USD
   profit_margin: profit / revenue #ratio
 )
 
@@ -123,9 +123,9 @@ table orders (
   revenue_recognized: status in ('Processing', 'Shipped', 'Complete')
 
   /* Agg expressions */
-  revenue: sum(case when revenue_recognized then amount else 0 end) #units=usd
-  cogs: sum(case when revenue_recognized then cost else 0 end) #units=usd
-  profit: revenue - cogs #units=usd -- even though there are no agg functions here, this is still aggregative as it references other aggregative expressions
+  revenue: sum(case when revenue_recognized then amount else 0 end) #currency=USD
+  cogs: sum(case when revenue_recognized then cost else 0 end) #currency=USD
+  profit: revenue - cogs #currency=USD -- even though there are no agg functions here, this is still aggregative as it references other aggregative expressions
   profit_margin: profit / revenue #ratio
 )
 ```
@@ -138,7 +138,7 @@ There isn't always a SQL expression that can tip Graphene to the semantic meanin
 - The field could be a base column that has no source expression
 - There might not be enough information in the expression (eg. what currency a float is tied to)
 
-For this reason, some metadata should be set explicitly in the GSQL model, using annotations. Metadata annotations resemble hashtags (eg. `#ratio`, `#units=usd`) that can be inlined or written above the object they decorate.
+For this reason, some metadata should be set explicitly in the GSQL model, using annotations. Metadata annotations resemble hashtags (eg. `#ratio`, `#currency=USD`) that can be inlined or written above the object they decorate.
 
 #### Recognized metadata
 
@@ -146,9 +146,12 @@ For this reason, some metadata should be set explicitly in the GSQL model, using
 |---|---|---|
 | `#ratio` | no | Value is 0–1; rendered as `value × 100%` (e.g. `0.42` → `42%`) |
 | `#pct` | no | Value is already 0–100; rendered as `value%` (e.g. `42` → `42%`) |
-| `#units=<currency>` | no | Adds currency symbol and compacts to K/M/B. Accepted values: `usd`, `eur`, `gbp`, `cad`, `aud`, `jpy` |
+| `#currency=<code>` | no | Adds currency symbol and compacts to K/M/B. Accepts ISO 4217 currency codes like `USD`, `EUR`, and `JPY` |
+| `#unit=<unit>` | no | Appends the provided value to the end of labels in visualizations (e.g. `unit=minutes` appends "minutes", or "(minutes)" on axes). Any non-empty value is accepted |
 | `#timeGrain=<grain>` | yes (from `date_trunc`, `date_bin`, casts) | Controls time axis label format. Values: `year`, `quarter`, `month`, `week`, `day`, `hour`, `minute`, `second` |
-| `#timeOrdinal=<ordinal>` | yes (from `extract`) | Treats values as ordinal positions on a categorical axis. Values: `hour_of_day`, `day_of_month`, `day_of_year`, `week_of_year`, `month_of_year`, `quarter_of_year`, `dow_0s` (0=Sun), `dow_1s` (1=Sun), `dow_1m` (1=Mon) |
+| `#timeOrdinal=<ordinal>` | yes (from `extract`) | Treats extracted time values as ordered positions. Values: `hour_of_day`, `day_of_month`, `day_of_year`, `week_of_year`, `month_of_year`, `quarter_of_year`, `dow_0s` (0=Sun), `dow_1s` (1=Sun), `dow_1m` (1=Mon) |
+| `#description=<text>` | no | Description text for a table or field. `--` comments are also collected as descriptions |
+| `#pii` | no | Marks a field as containing personally identifiable information. |
 
 ## `select` statements
 
@@ -241,15 +244,15 @@ table orders (
   user_id BIGINT
   created_at DATETIME
   status STRING -- One of 'Processing', 'Shipped', 'Complete', 'Cancelled', 'Returned'
-  amount FLOAT -- Amount paid by customer #units=usd
-  cost FLOAT -- Cost of materials #units=usd
+  amount FLOAT -- Amount paid by customer #currency=USD
+  cost FLOAT -- Cost of materials #currency=USD
 
   join one users on user_id = users.id
 
   revenue_recognized: status in ('Processing', 'Shipped', 'Complete')
-  revenue: sum(case when revenue_recognized then amount else 0 end) #units=usd
-  cogs: sum(case when revenue_recognized then cost else 0 end) #units=usd
-  profit: revenue - cogs #units=usd
+  revenue: sum(case when revenue_recognized then amount else 0 end) #currency=USD
+  cogs: sum(case when revenue_recognized then cost else 0 end) #currency=USD
+  profit: revenue - cogs #currency=USD
   profit_margin: profit / revenue #ratio
 )
 ```
@@ -330,15 +333,15 @@ table orders (
   user_id BIGINT
   created_at DATETIME
   status STRING -- One of 'Processing', 'Shipped', 'Complete', 'Cancelled', 'Returned'
-  amount FLOAT -- Amount paid by customer #units=usd
-  cost FLOAT -- Cost of materials #units=usd
+  amount FLOAT -- Amount paid by customer #currency=USD
+  cost FLOAT -- Cost of materials #currency=USD
 
   join one users on user_id = users.id
 
   revenue_recognized: status in ('Processing', 'Shipped', 'Complete')
-  revenue: sum(case when revenue_recognized then amount else 0 end) #units=usd
-  cogs: sum(case when revenue_recognized then cost else 0 end) #units=usd
-  profit: revenue - cogs #units=usd
+  revenue: sum(case when revenue_recognized then amount else 0 end) #currency=USD
+  cogs: sum(case when revenue_recognized then cost else 0 end) #currency=USD
+  profit: revenue - cogs #currency=USD
   profit_margin: profit / revenue #ratio
 )
 
@@ -351,7 +354,7 @@ table users (
   join many orders on id = orders.user_id
   join one user_facts on id = user_facts.id
 
-  ltv: user_facts.ltv #units=usd
+  ltv: user_facts.ltv #currency=USD
   lifetime_orders: user_facts.lifetime_orders
 )
 
@@ -388,6 +391,6 @@ We can extend this table to add measures or joins:
 extend regional_orders (
   join one regions on region = regions.name
 
-  avg_order_value: total_revenue / num_orders #units=usd
+  avg_order_value: total_revenue / num_orders #currency=USD
 )
 ```

package/dist/ui/component-utilities/enrich.ts

@@ -289,7 +289,7 @@ function inferAxesFromEncodedFields(config: NormalConfig, fields: Field[], rows:
   // the y-axis line reads like an extra vertical grid line at the left edge.
   // Hide the paired y-axis line unless the caller explicitly configured it.
   for (let [axisIndex, axis] of config.xAxis.entries()) {
-    if (!axis?.field?.metadata?.timeOrdinal) continue
+    if (!axis?.field?.metadata?.timeOrdinal && axis?.field?.metadata?.timeGrain !== 'year') continue
 
     let yAxisIndexes = config.series.filter(entry => Number(entry?.xAxisIndex ?? 0) === axisIndex).map(entry => Number(entry?.yAxisIndex ?? 0))
     for (let yAxisIndex of yAxisIndexes) {
@@ -406,7 +406,7 @@ function valueFormatting(config: NormalConfig, fields: Field[]) {
   let valueAxes = [...config.xAxis, ...config.yAxis].filter(axis => axis?.type === 'value' && !axis.field?.metadata?.timeOrdinal)
   for (let axis of valueAxes) {
     if (axis.axisLabel?.formatter != null) continue
-    axis.axisLabel = {...axis.axisLabel, formatter: makeValueFormatter(axis.field ? [axis.field] : [])}
+    axis.axisLabel = {...axis.axisLabel, formatter: makeValueFormatter(axis.field ? [axis.field] : [], {unitStyle: 'axis'})}
   }
 
   for (let series of config.series) {
@@ -508,22 +508,24 @@ function barLabelPositioning(config: NormalConfig) {
   }
 }
 
-// Match series data labels to the assigned y-axis formatter when labels are enabled.
-// This keeps label formatting in sync with the y-axis without asking callers to repeat it.
-// labelsUseYAxisFormat depends on valueAxisFormatting running first so labels inherit axis formatting.
+// Match series data labels to the assigned value field when labels are enabled.
+// This keeps label formatting in sync with tooltips without asking callers to repeat it.
+// labelsUseYAxisFormat depends on valueFormatting running first so labels inherit axis formatting.
 function labelsUseYAxisFormat(config: NormalConfig, fields: Field[]) {
   for (let series of config.series) {
     // No-op when labels are off or already explicitly formatted.
     if (!series?.label || series.label.show !== true || series.label.formatter != null) continue
 
-    let yField = getSeriesValueField(series, fields)?.name
+    let valueField = getSeriesValueField(series, fields)
+    let yField = valueField?.name
     let axisIndex = Number(series.yAxisIndex ?? 0)
     let axisFormatter = config.yAxis[axisIndex]?.axisLabel?.formatter
-    if (typeof axisFormatter !== 'function') continue
+    let labelFormatter = valueField ? makeValueFormatter([valueField]) : axisFormatter
+    if (typeof labelFormatter !== 'function') continue
 
     // ECharts can pass different value shapes depending on series/transform shape.
     // We resolve the numeric value in a few fallback steps so labels always use the
-    // same value the y-axis is formatting.
+    // same field that tooltips format.
     series.label.formatter = (params: unknown) => {
       let typed = params as {value?: unknown; data?: Record<string, unknown>}
       let value = typed?.value
@@ -535,7 +537,7 @@ function labelsUseYAxisFormat(config: NormalConfig, fields: Field[]) {
         }
       }
 
-      return formatAxisValue(axisFormatter, value)
+      return formatAxisValue(labelFormatter, value)
     }
   }
 }
@@ -678,36 +680,34 @@ function inferAxisFromField(field: Field | undefined, rows: Record<string, any>[
       axis.max = domain[1]
     }
 
-    if (field.metadata?.timeOrdinal) {
-      axis.minInterval = 1
+    if (field.metadata?.timeGrain === 'year') {
+      // Pin year ticks to evenly-spaced integers so a domain like [2000, 2005]
+      // doesn't end up with the 2000/2002/2004/2005 stub-label pattern.
+      let ticks = domain ? niceIntegerTicks(domain[0], domain[1]) : []
+      axis.axisLabel = {customValues: ticks, formatter: (value: unknown) => (Number.isInteger(Number(value)) ? String(Number(value)) : '')}
+      axis.axisTick = {customValues: ticks}
+      axis.axisLine = {show: false}
+      axis.splitLine = {show: false}
+      return axis
+    }
 
+    if (field.metadata?.timeOrdinal) {
       // Ordinal values are numeric so we use a value axis with a fixed domain, but
       // visually they are discrete buckets. Hide value-axis grid lines by default
-      // and ask ECharts for denser integer ticks than its generic value defaults.
+      // and pin tick positions to evenly-spaced integers so we never get a stub
+      // boundary label (e.g. weeks 1, 14, 27, 40, 53 instead of 1, 11, 21, 31, 41, 51, 53).
+      let ticks = domain ? niceIntegerTicks(domain[0], domain[1]) : []
       axis.axisLine = {show: false}
       axis.splitLine = {show: false}
-      axis.axisLabel = {hideOverlap: true, formatter: (value: unknown) => (domain && (Number(value) < domain[0] || Number(value) > domain[1]) ? '' : formatTimeOrdinal(field, value))}
-
-      // splitNumber is a hint rather than an exact spacing, but it works better
-      // with value-axis bars because interval can fight the half-bucket padding we
-      // add later. These defaults keep compact ordinals readable without forcing
-      // every possible day/week label.
-      let ordinal = field.metadata.timeOrdinal
-      if (ordinal === 'month_of_year' || ordinal === 'quarter_of_year' || ordinal === 'dow_0s' || ordinal === 'dow_1s' || ordinal === 'dow_1m')
-        axis.splitNumber = domain ? domain[1] - domain[0] + 1 : 5
-      if (ordinal === 'hour_of_day') axis.splitNumber = 8
-      if (ordinal === 'day_of_month') axis.splitNumber = 6
-      if (ordinal === 'week_of_year') axis.splitNumber = 13
-      if (ordinal === 'day_of_year') axis.splitNumber = 12
-
+      axis.axisLabel = {
+        hideOverlap: true,
+        customValues: ticks,
+        formatter: (value: unknown) => (domain && (Number(value) < domain[0] || Number(value) > domain[1]) ? '' : formatTimeOrdinal(field, value)),
+      }
+      axis.axisTick = {customValues: ticks}
       axis.axisPointer = {label: {formatter: (value: unknown) => formatTimeOrdinal(field, value)}}
       return axis
     }
-
-    if (field.metadata?.timePart === 'year') {
-      axis.minInterval = 1
-      axis.axisLabel = {formatter: (value: unknown) => (Number.isInteger(Number(value)) ? String(Number(value)) : '')}
-    }
   }
 
   if (type === 'category' && field.metadata?.timeOrdinal) {
@@ -718,9 +718,50 @@ function inferAxisFromField(field: Field | undefined, rows: Record<string, any>[
   return axis
 }
 
+// Pick evenly-spaced integer tick positions across [min, max] for ordinal/year value axes.
+// Strategy:
+//   1. If the range is small enough that labeling every value is readable
+//      (≤ denseLimit, sized to cover the 12-month ordinal), label every value.
+//   2. Otherwise prefer step sizes that divide the range exactly so the last tick
+//      lands on max (avoiding the stub-label problem where ECharts' auto-picked step
+//      doesn't reach max).
+//   3. If no candidate divides the range cleanly, fall back to the smallest step that
+//      fits inside targetMax ticks; the final tick may fall short of max, but the chart's
+//      domain still extends visually via half-bucket padding.
+function niceIntegerTicks(min: number, max: number, targetMin = 4, targetMax = 8, denseLimit = 13): number[] {
+  if (!Number.isFinite(min) || !Number.isFinite(max) || max < min) return []
+  let range = max - min
+  if (range === 0) return [min]
+  if (range + 1 <= denseLimit) return tickRange(min, max, 1)
+
+  let candidates = [1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 5000]
+  for (let step of candidates) {
+    if (range % step !== 0) continue
+    let count = range / step + 1
+    if (count >= targetMin && count <= targetMax) return tickRange(min, max, step)
+  }
+  for (let step of candidates) {
+    let count = Math.floor(range / step) + 1
+    if (count >= targetMin && count <= targetMax) return tickRange(min, max, step)
+  }
+  return [min, max]
+}
+
+function tickRange(min: number, max: number, step: number): number[] {
+  let values: number[] = []
+  for (let v = min; v <= max + 1e-9; v += step) values.push(Math.round(v))
+  return values
+}
+
 // Return the natural numeric domain for temporal values that are encoded as numbers.
 function temporalValueDomain(field: Field, rows: Record<string, any>[]): [number, number] | undefined {
   let ordinal = field.metadata?.timeOrdinal
+  if (field.metadata?.timeGrain === 'year') {
+    let values = rows.map(row => Number(row?.[field.name])).filter(value => Number.isFinite(value))
+    if (values.length === 0) return undefined
+    return [Math.min(...values), Math.max(...values)]
+  }
+
   if (ordinal === 'hour_of_day') return [0, 23]
   if (ordinal === 'day_of_month') return [1, 31]
   if (ordinal === 'day_of_year') return [1, 366]
@@ -729,12 +770,6 @@ function temporalValueDomain(field: Field, rows: Record<string, any>[]): [number
   if (ordinal === 'quarter_of_year') return [1, 4]
   if (ordinal === 'dow_0s') return [0, 6]
   if (ordinal === 'dow_1s' || ordinal === 'dow_1m') return [1, 7]
-
-  if (field.metadata?.timePart == 'year') {
-    let values = rows.map(row => Number(row?.[field.name])).filter(value => Number.isFinite(value))
-    if (values.length === 0) return undefined
-    return [Math.min(...values), Math.max(...values)]
-  }
 }
 
 // Series sometimes encode their value field as `y` and sometimes as `value` (pie, funnel, etc).

package/dist/ui/component-utilities/format.ts

@@ -1,6 +1,6 @@
 import type {Field} from './types.ts'
 
-const currencySymbols = {usd: '$', eur: '€', gbp: '£', cad: 'C$', aud: 'A$', jpy: '¥'} as const
+const supportedCurrencyCodes = new Set(Intl.supportedValuesOf('currency'))
 const percent = new Intl.NumberFormat('en-US', {maximumFractionDigits: 0})
 const currencyCompact = new Intl.NumberFormat('en-US', {notation: 'compact', maximumFractionDigits: 1})
 const monthYearFormatter = new Intl.DateTimeFormat('en-US', {month: 'long', year: 'numeric'})
@@ -11,6 +11,8 @@ const yearMonths = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep
 const titleCaseAcronyms = ['id', 'gdp']
 const titleCaseLowerWords = ['of', 'the', 'and', 'in', 'on']
 
+type ValueFormatterOptions = {unitStyle?: 'label' | 'axis'}
+
 // Formats a raw column name into a readable title.
 export function formatTitle(column: string) {
   let cleaned = column.replace(/"/g, '').replace(/_/g, ' ')
@@ -24,43 +26,56 @@ export function formatTitle(column: string) {
 // ECharts valueFormatter will take different arguments depending on the chart type.
 // For bar/line/area it's just a number
 // for scatter, it's [x,y], for candlestick [open, close, low, high], etc
-export function makeValueFormatter(fields: Field[] = []) {
+export function makeValueFormatter(fields: Field[] = [], options: ValueFormatterOptions = {}) {
   return (value: unknown) => {
-    if (Array.isArray(value)) return value.map((entry, index) => formatSingleValue(entry, fields[index] || fields[0])).join(', ')
-    return formatSingleValue(value, fields[0])
+    if (Array.isArray(value)) return value.map((entry, index) => formatSingleValue(entry, fields[index] || fields[0], options)).join(', ')
+    return formatSingleValue(value, fields[0], options)
   }
 }
 
-// Formats one numeric value with field metadata (units, ratio/pct, compact notation).
-export function formatSingleValue(value: any, field?: Field) {
+// Formats one numeric value with field metadata (currency, ratio/pct, compact notation).
+export function formatSingleValue(value: any, field?: Field, options: ValueFormatterOptions = {}) {
   let amount = Number(value)
   if (!Number.isFinite(amount)) return String(value ?? '')
 
   if (field?.metadata?.ratio) return `${percent.format(amount * 100)}%`
   if (field?.metadata?.pct) return `${percent.format(amount)}%`
 
-  let unit = field?.metadata?.units?.toLowerCase() as keyof typeof currencySymbols | undefined
-  let currencyUnit = unit != null && unit in currencySymbols ? unit : undefined
-  if (currencyUnit) {
+  let currency = field?.metadata?.currency?.toUpperCase()
+  if (currency && supportedCurrencyCodes.has(currency)) {
     let sign = amount < 0 ? '-' : ''
     let formatted = currencyCompact.format(Math.abs(amount)).replace('K', 'k').replace('M', 'm').replace('B', 'b')
-    return `${sign}${currencySymbols[currencyUnit]}${formatted}`
+    return `${sign}${formatCurrencySymbol(currency)}${formatted}`
   }
 
-  if (amount === 0) return '0'
+  if (amount === 0) return addUnit('0', field, options)
   let sign = amount < 0 ? '-' : ''
   let absolute = Math.abs(amount)
+  let formatted = ''
+
+  if (absolute >= 1e12) formatted = `${compactValue(absolute / 1e12)}T`
+  else if (absolute >= 1e9) formatted = `${compactValue(absolute / 1e9)}B`
+  else if (absolute >= 1e6) formatted = `${compactValue(absolute / 1e6)}M`
+  else if (absolute >= 1e3) formatted = `${compactValue(absolute / 1e3)}k`
+  else if (absolute >= 1) formatted = compactValue(absolute)
+  else if (absolute >= 1e-3) formatted = compactValue(absolute)
+  else if (absolute >= 1e-6) formatted = `${compactValue(absolute * 1e3)}m`
+  else if (absolute >= 1e-9) formatted = `${compactValue(absolute * 1e6)}u`
+  else if (absolute >= 1e-12) formatted = `${compactValue(absolute * 1e9)}n`
+  else formatted = compactValue(absolute)
+
+  return addUnit(`${sign}${formatted}`, field, options)
+}
+
+function formatCurrencySymbol(currency: string) {
+  let parts = new Intl.NumberFormat('en-US', {style: 'currency', currency, currencyDisplay: 'symbol', maximumFractionDigits: 0}).formatToParts(0)
+  return parts.find(part => part.type === 'currency')?.value || currency
+}
 
-  if (absolute >= 1e12) return `${sign}${compactValue(absolute / 1e12)}T`
-  if (absolute >= 1e9) return `${sign}${compactValue(absolute / 1e9)}B`
-  if (absolute >= 1e6) return `${sign}${compactValue(absolute / 1e6)}M`
-  if (absolute >= 1e3) return `${sign}${compactValue(absolute / 1e3)}k`
-  if (absolute >= 1) return `${sign}${compactValue(absolute)}`
-  if (absolute >= 1e-3) return `${sign}${compactValue(absolute)}`
-  if (absolute >= 1e-6) return `${sign}${compactValue(absolute * 1e3)}m`
-  if (absolute >= 1e-9) return `${sign}${compactValue(absolute * 1e6)}u`
-  if (absolute >= 1e-12) return `${sign}${compactValue(absolute * 1e9)}n`
-  return `${sign}${compactValue(absolute)}`
+function addUnit(value: string, field: Field | undefined, options: ValueFormatterOptions) {
+  let unit = field?.metadata?.unit?.trim()
+  if (!unit) return value
+  return options.unitStyle === 'axis' ? `${value} (${unit})` : `${value} ${unit}`
 }
 
 // Creates a formatter function that renders date/timestamp values based on field metadata.timeGrain.

package/dist/ui/component-utilities/theme.ts

@@ -111,7 +111,6 @@ registerTheme('graphene-theme', {
     containLabel: false,
   },
   line: {
-    smooth: true,
     symbol: 'emptyCircle',
     symbolSize: 6,
     lineStyle: {width: 2},

package/dist/ui/components/AreaChart.svelte

@@ -59,7 +59,7 @@
       tooltip: {trigger: 'axis'},
       legend: {show: Boolean(splitBy || y2 || yFields.length > 1)},
       xAxis: {},
-      yAxis: [{max: stackPercentage ? 1 : undefined}, ...(y2 ? [{}] : [])],
+      yAxis: [{max: stackPercentage ? 1 : undefined}, ...(y2 ? [{alignTicks: true}] : [])],
       series,
     }
   }

package/dist/ui/components/BarChart.svelte

@@ -75,7 +75,7 @@
       tooltip: {trigger: 'axis'},
       legend: {show: Boolean(splitBy || y2 || (!horizontal && yFields.length > 1) || (horizontal && xFields.length > 1))},
       xAxis: {},
-      yAxis: [{max: stackPercentage ? 1 : undefined}, ...(y2 ? [{}] : [])],
+      yAxis: [{max: stackPercentage ? 1 : undefined}, ...(y2 ? [{alignTicks: true}] : [])],
       series,
     }
   }

package/dist/ui/components/LineChart.svelte

@@ -55,7 +55,7 @@
       tooltip: {trigger: 'axis'},
       legend: {show: Boolean(splitBy || y2 || yFields.length > 1)},
       xAxis: {},
-      yAxis: [{}, ...(y2 ? [{}] : [])],
+      yAxis: [{}, ...(y2 ? [{alignTicks: true}] : [])],
       series,
     }
   }

package/dist/ui/internal/PageNavGroup.svelte

@@ -115,8 +115,8 @@
     return nodes
       .map(n => n.type === 'folder' && n.children?.length ? {...n, children: sortNodes(n.children)} : n)
       .sort((a, b) => {
-        if (a.label === 'Home') return -1
-        if (b.label === 'Home') return 1
+        if (a.path?.toLowerCase() === 'index.md') return -1
+        if (b.path?.toLowerCase() === 'index.md') return 1
         if (a.type !== b.type) return a.type === 'folder' ? -1 : 1
         return a.label.localeCompare(b.label)
       })

package/dist/ui/internal/Sidebar.svelte

@@ -1,18 +1,18 @@
 <script>
-  // Content-agnostic sidebar shell. The panel slides in as an overlay when the
-  // user hovers the paired SidebarToggle button (rendered separately by the host)
-  // or the panel itself. Styling values are ported from shadcn-svelte's sidebar registry.
+  // Content-agnostic sidebar shell. By default the panel slides in as an overlay
+  // when the user hovers the paired SidebarToggle button or the panel itself;
+  // alwaysOpen keeps the same shell visible for persistent navigation.
   import {sidebar} from './sidebar.svelte.js'
-  let {children, width = '16rem'} = $props()
+  let {children, width = '16rem', alwaysOpen = false} = $props()
 </script>
 
 <nav
   id="nav"
   class="sb-panel pretty-scrollbar"
   style="--sb-w:{width}"
-  data-open={sidebar.open}
-  onmouseenter={sidebar.enter}
-  onmouseleave={sidebar.leave}
+  data-open={alwaysOpen || sidebar.open}
+  onmouseenter={() => { if (!alwaysOpen) sidebar.enter() }}
+  onmouseleave={() => { if (!alwaysOpen) sidebar.leave() }}
 >
   <div class="sb-inner">
     {@render children?.()}

package/dist/ui/internal/sidebar.svelte.js

@@ -1,4 +1,4 @@
-let state = $state({ open: false });
+let state = $state({ open: false, pinned: false });
 let closeTimer;
 const sidebar = {
   get open() {
@@ -10,7 +10,17 @@ const sidebar = {
   },
   leave() {
     clearTimeout(closeTimer);
+    if (state.pinned) return;
     closeTimer = setTimeout(() => state.open = false, 120);
+  },
+  pin() {
+    clearTimeout(closeTimer);
+    state.pinned = true;
+    state.open = true;
+  },
+  unpin() {
+    state.pinned = false;
+    this.leave();
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphenedata/cli",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "license": "Elastic-2.0",
   "author": "Graphene Systems Inc",
   "repository": {