drizzle-cube 0.7.0 → 0.7.1

package/dist/adapters/{utils-tjiwXFnP.js → utils-DboNUT3A.js}

@@ -542,7 +542,7 @@ var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescr
 	"chart.configText.add_2_or_more_measures_they_become_the_x_axis_categories_in_the_order_li": "Add 2 or more measures — they become the X-axis categories in the order listed",
 	"chart.configText.add_an_accent_colored_border_on_one_side_of_the_content": "Add an accent-colored border on one side of the content",
 	"chart.configText.all_fields_to_display_as_columns": "All fields to display as columns",
-	"chart.configText.array_of_value_0_1_fraction_color_bands_shown_as_outer_arc_markers": "Array of {value (0–1 fraction), color} bands shown as outer arc markers",
+	"chart.gauge.thresholds.description": "Each band runs from its value up to the next one. Values are on the gauge’s own scale.",
 	"chart.configText.axes_categories": "Axes (Categories)",
 	"chart.configText.bubble_colour": "Bubble Colour",
 	"chart.configText.bubble_labels": "Bubble Labels",
@@ -1585,7 +1585,11 @@ var e = Object.create, t = Object.defineProperty, n = Object.getOwnPropertyDescr
 	"chart.option.proportionBarLabels.label": "Show labels",
 	"chart.runtime.summarySince": "since {period}",
 	"chart.option.showPoints.label": "Show data points",
-	"chart.option.showPoints.description": "Draw a marker at every data point. Turn off for dense series, where the markers obscure the line"
+	"chart.option.showPoints.description": "Draw a marker at every data point. Turn off for dense series, where the markers obscure the line",
+	"chart.gauge.thresholds.from": "Band starts at",
+	"chart.gauge.thresholds.colour": "Band colour",
+	"chart.gauge.thresholds.add": "Add band",
+	"chart.gauge.thresholds.remove": "Remove band"
 };
 function f(e, t) {
 	let n = d[e];

package/dist/adapters/utils.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-C5FLHK04.cjs");exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.S,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./utils-BoOeig94.cjs");exports.buildTransformedQuery=e.t,exports.calculateQueryComplexity=e.n,exports.formatCubeResponse=e.r,exports.formatErrorResponse=e.i,exports.formatMetaResponse=e.a,exports.formatSqlResponse=e.o,exports.formatSqlString=e.S,exports.generateRequestId=e.s,exports.getDatabaseType=e.c,exports.handleBatchRequest=e.l,exports.handleDiscover=e.p,exports.handleDryRun=e.u,exports.handleLoad=e.m,exports.handleSuggest=e.d,exports.handleValidate=e.f,exports.normalizeQueryFields=e.h;

package/dist/adapters/utils.js

@@ -1,2 +1,2 @@
-import { S as e, a as t, c as n, d as r, f as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-tjiwXFnP.js";
+import { S as e, a as t, c as n, d as r, f as i, h as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h } from "./utils-DboNUT3A.js";
 export { m as buildTransformedQuery, l as calculateQueryComplexity, f as formatCubeResponse, o as formatErrorResponse, t as formatMetaResponse, u as formatSqlResponse, e as formatSqlString, p as generateRequestId, n as getDatabaseType, s as handleBatchRequest, d as handleDiscover, h as handleDryRun, c as handleLoad, r as handleSuggest, i as handleValidate, a as normalizeQueryFields };

package/dist/cjs/client/charts/chartConfigs.d.ts

@@ -28,7 +28,7 @@ export interface DisplayOptionConfig {
     /** Display label for the option */
     label: string;
     /** Type of input control to render */
-    type: 'boolean' | 'string' | 'number' | 'select' | 'color' | 'paletteColor' | 'axisFormat' | 'stringArray' | 'buttonGroup';
+    type: 'boolean' | 'string' | 'number' | 'select' | 'color' | 'paletteColor' | 'axisFormat' | 'stringArray' | 'buttonGroup' | 'thresholdBands';
     /** Default value for the option */
     defaultValue?: any;
     /** Placeholder text for string/number inputs */

package/dist/cjs/client/components/charts/GaugeChart.d.ts

@@ -1,4 +1,12 @@
 import { default as React } from 'react';
 import { ChartProps } from '../../types.js';
+/**
+ * Gauge chart: a 270° dial whose arc *is* the threshold banding — one thick,
+ * rounded segment per threshold with a small gap between them — read by a
+ * tapered needle, with numeric scale labels at the band boundaries and the
+ * measure label + value stacked below the centre.
+ *
+ * All geometry lives in `gaugeChartHelpers.ts`; this component only renders it.
+ */
 declare const GaugeChart: React.MemoExoticComponent<({ data, chartConfig, displayConfig, height, }: ChartProps) => React.JSX.Element>;
 export default GaugeChart;

package/dist/cjs/client/components/charts/gaugeChartHelpers.d.ts

@@ -1,36 +1,141 @@
 import { AxisFormatConfig, ThresholdBand } from '../../types.js';
 /**
- * Co-located helpers for GaugeChart: pure geometry/value math and threshold
- * parsing extracted from the component so the render body stays flat. Pure
- * extraction — no behaviour change.
+ * Co-located geometry/value maths for {@link GaugeChart}.
+ *
+ * Everything here is pure so the component stays declarative: it reads a
+ * layout, a list of band segments, a list of scale ticks and a needle path,
+ * then renders them.
+ *
+ * ## Angle convention
+ * d3-shape's: `0` points at 12 o'clock and positive angles run clockwise. The
+ * dial sweeps 270°, from `START_ANGLE` (-135°, lower-left) to `END_ANGLE`
+ * (+135°, lower-right).
+ *
+ * ## Threshold semantics
+ * A {@link ThresholdBand}'s `value` is the **lower bound** of its band, as a
+ * 0–1 fraction of the min→max range. So `[{0, red}, {0.5, amber}, {0.7, green}]`
+ * paints 0–50% red, 50–70% amber and 70–100% green. This matches
+ * {@link resolveColor}, and the invariant
+ * `bandContaining(f).color === resolveColor(f)` holds for every `f` in [0, 1).
  */
+/** Dial start: -135°, lower-left. */
 export declare const START_ANGLE: number;
+/** Dial end: +135°, lower-right. */
 export declare const END_ANGLE: number;
-export declare const TRACK_COLOR = "#e2e8f0";
-export declare const DEFAULT_FILL = "#6366f1";
+/** Total dial sweep in radians (270°). */
+export declare const ANGLE_SPAN: number;
+/** Neutral band colour for the region below every configured threshold. */
+export declare const DEFAULT_FILL = "var(--dc-accent)";
+/** Angular gap rendered between adjacent band segments (radians, ~2.3°). */
+export declare const BAND_GAP_RADIANS = 0.04;
+/**
+ * Height of the 270° arc's bounding box as a multiple of its radius.
+ * The arc spans y from `-r` (top) to `+r·cos45°` (the two lower tips).
+ */
+export declare const ARC_BBOX_HEIGHT_RATIO: number;
+/** Width of the 270° arc's bounding box as a multiple of its radius. */
+export declare const ARC_BBOX_WIDTH_RATIO = 2;
 export declare function parseNum(v: unknown): number | null;
 export declare function clamp(v: number, lo: number, hi: number): number;
+/** A finite `value`, or `fallback` when it is undefined / NaN / infinite. */
+export declare function finiteOr(value: number | undefined | null, fallback: number): number;
+/** Map a 0–1 fraction of the range onto its dial angle. */
+export declare function fractionToAngle(fraction: number): number;
 export declare function valueToAngle(value: number, min: number, max: number): number;
+/** Cartesian point at `angle`/`radius` in the d3 angle convention. */
+export declare function polarPoint(angle: number, radius: number): {
+    x: number;
+    y: number;
+};
 export declare function resolveColor(fraction: number, thresholds: ThresholdBand[]): string;
-export declare function buildArcPath(innerRadius: number, outerRadius: number, startAngle: number, endAngle: number): string;
+export declare function buildArcPath(innerRadius: number, outerRadius: number, startAngle: number, endAngle: number, cornerRadius?: number): string;
 /** Parse the displayConfig.thresholds value (array or JSON string) into bands. */
 export declare function parseThresholds(raw: unknown): ThresholdBand[];
+/** Clamp threshold fractions into [0, 1] and sort them ascending. */
+export declare function normalizeThresholds(thresholds: ThresholdBand[]): ThresholdBand[];
 export interface ThresholdArcBand {
     color: string;
-    start: number;
-    end: number;
+    /** Lower bound of the band, as a 0–1 fraction of the min→max range. */
+    startFraction: number;
+    /** Upper bound of the band, as a 0–1 fraction of the min→max range. */
+    endFraction: number;
+    /** Dial angle of {@link startFraction}. */
+    startAngle: number;
+    /** Dial angle of {@link endFraction}. */
+    endAngle: number;
 }
-/** Build the outer-ring threshold arc bands (in fraction space 0..1). */
+/**
+ * Split the dial into coloured bands. The bands tile the whole 0–1 range with
+ * no holes: a leading neutral band covers anything below the first threshold,
+ * and the last threshold's band runs to 1. Zero-width bands (duplicate
+ * thresholds, or one pinned at 1) are dropped.
+ *
+ * With no thresholds configured the dial is a single neutral band, so the
+ * gauge still renders a full arc.
+ */
 export declare function buildThresholdBands(thresholds: ThresholdBand[]): ThresholdArcBand[];
+export interface GaugeBandSegment {
+    color: string;
+    startAngle: number;
+    endAngle: number;
+}
+/**
+ * Turn logical bands into drawable segments by inserting a gap at every
+ * *internal* boundary (the dial's outer ends keep the full 270° sweep).
+ * Segments too narrow to render cleanly with rounded caps are dropped.
+ */
+export declare function buildBandSegments(bands: ThresholdArcBand[], gap?: number): GaugeBandSegment[];
+export interface GaugeScaleTick {
+    fraction: number;
+    value: number;
+    angle: number;
+}
+/**
+ * Numeric scale ticks at the band boundaries (plus the dial's start and end).
+ * Ticks are thinned back-to-front so the max is always kept and no two labels
+ * collide.
+ */
+export declare function buildScaleTicks(bands: ThresholdArcBand[], minValue: number, maxValue: number): GaugeScaleTick[];
+/** Triangular needle: wide at the hub, tapering to a point at `length`. */
+export declare function buildNeedlePath(angle: number, length: number, halfWidth: number): string;
+export interface GaugeLayout {
+    /** Dial centre in SVG coordinates. */
+    cx: number;
+    cy: number;
+    radius: number;
+    outerRadius: number;
+    innerRadius: number;
+    /** Corner radius that fully rounds a band segment's ends. */
+    bandCornerRadius: number;
+    /** Radius at which scale tick labels are centred (just inside the band). */
+    tickRadius: number;
+    needleLength: number;
+    needleHalfWidth: number;
+    hubRadius: number;
+    tickFontSize: number;
+    labelFontSize: number;
+    labelY: number;
+    valueFontSize: number;
+    valueY: number;
+}
+/**
+ * Size and position the dial so its 270° bounding box is centred in, and fits
+ * inside, a `width` x `height` box. Everything else is expressed as a ratio of
+ * the resulting radius so the gauge scales smoothly.
+ */
+export declare function computeGaugeLayout(width: number, height: number): GaugeLayout;
 export interface GaugeGeometry {
     effectiveMax: number;
     clampedValue: number;
     fraction: number;
     fillColor: string;
-    fillAngle: number;
     needleAngle: number;
 }
-/** Compute the gauge's clamped value, fraction, fill colour, and angles. */
+/** Compute the gauge's clamped value, fraction, indicated colour and angle. */
 export declare function computeGaugeGeometry(rawValue: number, minValue: number, maxValue: number, thresholds: ThresholdBand[]): GaugeGeometry;
-/** Format a gauge value with the optional axis format, else locale string. */
+/**
+ * Format a gauge value. With a configured axis format this honours its unit,
+ * decimals and abbreviation (so a percent format renders `66.9%`); without one
+ * it falls back to the shared default numeric formatting (`66.94`).
+ */
 export declare function formatGaugeValue(value: number, yAxisFormat?: AxisFormatConfig): string;

package/dist/client/charts/chartConfigs.d.ts

@@ -28,7 +28,7 @@ export interface DisplayOptionConfig {
     /** Display label for the option */
     label: string;
     /** Type of input control to render */
-    type: 'boolean' | 'string' | 'number' | 'select' | 'color' | 'paletteColor' | 'axisFormat' | 'stringArray' | 'buttonGroup';
+    type: 'boolean' | 'string' | 'number' | 'select' | 'color' | 'paletteColor' | 'axisFormat' | 'stringArray' | 'buttonGroup' | 'thresholdBands';
     /** Default value for the option */
     defaultValue?: any;
     /** Placeholder text for string/number inputs */

package/dist/client/charts.js

@@ -1,14 +1,14 @@
-import { ct as e, dt as t, ft as n, lt as r, mt as i, pt as a, st as o, t as s, ut as c } from "./chunks/chart-data-table-SNSqZj9B.js";
-import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-DVOhLgxv.js";
-import { t as p } from "./chunks/chart-funnel-CkHSXp6h.js";
-import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-0avVzeDd.js";
-import { t as x } from "./chunks/chart-area-C-5ATxvi.js";
+import { ct as e, dt as t, ft as n, lt as r, mt as i, pt as a, st as o, t as s, ut as c } from "./chunks/chart-data-table-DoDHQRe7.js";
+import { d as l, l as u, s as d, u as f } from "./chunks/chart-activity-grid-4jfS8khG.js";
+import { t as p } from "./chunks/chart-funnel-Cd7da_sa.js";
+import { a as m, i as h, n as g, o as _, r as v, s as y, t as b } from "./chunks/charts-loader-CwMcOfwT.js";
+import { t as x } from "./chunks/chart-area-Dol6s9no.js";
 import { i as S } from "./chunks/utils-CToHkuhU.js";
-import { t as C } from "./chunks/chart-bar-CPiLaXHP.js";
-import { t as w } from "./chunks/chart-line-CzvVL3Be.js";
-import { t as T } from "./chunks/chart-pie-CwRfwWWZ.js";
-import { t as E } from "./chunks/chart-scatter-BtLfAsZb.js";
-import { t as D } from "./chunks/chart-radar-Dfql2E7i.js";
-import { t as O } from "./chunks/chart-radial-bar-oE9OZ1IX.js";
-import { t as k } from "./chunks/chart-tree-map-DU5M3-qe.js";
+import { t as C } from "./chunks/chart-bar-5_niozi2.js";
+import { t as w } from "./chunks/chart-line-DlwOB7C7.js";
+import { t as T } from "./chunks/chart-pie-FGw66XAH.js";
+import { t as E } from "./chunks/chart-scatter-D9EcAiMQ.js";
+import { t as D } from "./chunks/chart-radar-D-eRDoiA.js";
+import { t as O } from "./chunks/chart-radial-bar-DgtkNTs3.js";
+import { t as k } from "./chunks/chart-tree-map-D_ACSSiB.js";
 export { d as CHART_COLORS, u as CHART_MARGINS, s as DataTable, p as FunnelChart, b as LazyChart, f as NEGATIVE_COLOR, l as POSITIVE_COLOR, x as RechartsAreaChart, C as RechartsBarChart, w as RechartsLineChart, T as RechartsPieChart, D as RechartsRadarChart, O as RechartsRadialBarChart, E as RechartsScatterChart, k as RechartsTreeMapChart, o as clearChartConfigCache, S as formatChartData, g as getAvailableChartTypes, e as getChartConfigAsync, r as getChartConfigSync, v as getUnavailableChartTypes, c as isChartConfigLoaded, h as isChartTypeAvailable, m as isValidChartType, t as loadAllChartConfigs, _ as preloadChart, n as preloadChartConfig, a as preloadChartConfigs, y as preloadCharts, i as useChartConfig };