drizzle-cube 0.7.0 → 0.7.1

package/dist/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/components.js

@@ -1,3 +1,3 @@
-import { D as e, O as t, X as n, a as r, h as i, i as a, m as o, n as s, p as c, r as l, s as u, t as d, w as f } from "./chunks/DashboardEditModal-ByXLlXZD.js";
+import { D as e, O as t, X as n, a as r, h as i, i as a, m as o, n as s, p as c, r as l, s as u, t as d, w as f } from "./chunks/DashboardEditModal-BOfLdTgV.js";
 import { a as p, n as m, o as h, r as g, s as _, t as v } from "./chunks/utils-CToHkuhU.js";
 export { u as AnalysisDisplayConfigPanel, l as AnalyticsDashboard, n as AnalyticsPortlet, d as DashboardEditModal, i as DashboardFilterBar, a as DashboardGrid, o as DashboardGridSurface, r as DashboardModals, e as DashboardProvider, f as DashboardToolbar, c as Modal, s as PortletContainer, v as createDashboardLayout, m as createSamplePortlet, g as findNextPosition, p as generatePortletId, h as generateResponsiveLayouts, t as useDashboardContext, _ as validateCubeQuery };

package/dist/client/hooks.js

@@ -1,5 +1,5 @@
-import { R as e } from "./chunks/chart-data-table-SNSqZj9B.js";
-import { S as t, a as n, c as r, d as i, i as a, l as o, n as s, o as c, r as l, s as u, t as d } from "./chunks/useDirtyStateTracking-Dc-Si4db.js";
-import { a as f, i as p, n as m, o as h, r as g, t as _ } from "./chunks/useExplainAI-DJbc7Lu4.js";
+import { R as e } from "./chunks/chart-data-table-DoDHQRe7.js";
+import { S as t, a as n, c as r, d as i, i as a, l as o, n as s, o as c, r as l, s as u, t as d } from "./chunks/useDirtyStateTracking-ZfChDEd3.js";
+import { a as f, i as p, n as m, o as h, r as g, t as _ } from "./chunks/useExplainAI-im9e1rVb.js";
 import { t as v } from "./chunks/useNotebookLayout-Ck3Z3uzg.js";
 export { m as createExplainQueryKey, c as createFlowQueryKey, r as createFunnelQueryKey, t as useCubeLoadQuery, t as useCubeQuery, e as useCubeMetaQuery, s as useDebounce, d as useDirtyStateTracking, p as useDryRunQueries, f as useDryRunQuery, _ as useExplainAI, g as useExplainQuery, l as useFilterValues, u as useFlowQuery, o as useFunnelQuery, i as useMultiCubeLoadQuery, h as useMultiDryRunQueries, v as useNotebookLayout, a as useResponsiveDashboard, n as useRetentionQuery };

package/dist/client/icons.js

@@ -1,2 +1,2 @@
-import { C as e, E as t, S as n, T as r, _ as i, b as a, g as o, v as s, w as c, x as l, y as u } from "./chunks/chart-data-table-SNSqZj9B.js";
+import { C as e, E as t, S as n, T as r, _ as i, b as a, g as o, v as s, w as c, x as l, y as u } from "./chunks/chart-data-table-DoDHQRe7.js";
 export { t as DEFAULT_ICONS, o as getChartTypeIcon, i as getFieldTypeIcon, s as getIcon, u as getIconData, a as getIconRegistry, l as getIconsByCategory, n as getMeasureTypeIcon, e as registerIcons, c as resetIcons, r as setIcon };

package/dist/client/index.js

@@ -1,19 +1,19 @@
-import { a as e, n as t, o as n, r, s as i } from "./chunks/vendor-cTfe9Kho.js";
+import { a as e, n as t, o as n, r, s as i } from "./chunks/vendor-Qa1s8oSX.js";
 import { n as a, t as o } from "./chunks/providers-DwQCKdGW.js";
-import { A as s, B as c, C as l, E as u, I as d, L as f, M as p, N as m, R as h, S as g, T as _, V as v, _ as y, b, c as x, g as S, j as C, k as w, l as T, s as E, v as D, w as O, x as k, y as A, z as j } from "./chunks/chart-data-table-SNSqZj9B.js";
-import { n as M, r as N } from "./chunks/chart-sankey-tK7Oz1bC.js";
-import { $ as P, A as F, B as I, D as L, E as ee, F as te, G as R, H as ne, I as re, J as ie, K as ae, L as oe, M as se, N as ce, O as le, P as ue, Q as de, R as fe, St as pe, U as me, V as he, W as ge, X as _e, Y as ve, Z as ye, _t as be, a as xe, at as Se, bt as Ce, c as we, ct as Te, dt as Ee, et as De, f as Oe, ft as ke, gt as Ae, h as je, ht as Me, i as Ne, it as Pe, k as Fe, lt as Ie, m as Le, mt as Re, n as ze, o as Be, ot as Ve, p as He, pt as Ue, q as We, r as Ge, st as Ke, t as qe, ut as Je, v as Ye, vt as Xe, w as Ze, xt as Qe, yt as $e, z as et } from "./chunks/DashboardEditModal-ByXLlXZD.js";
-import { S as tt, _ as nt, b as rt, c as it, d as at, f as ot, g as st, h as ct, l as lt, m as ut, o as dt, p as ft, s as pt, v as mt, y as ht } from "./chunks/useDirtyStateTracking-Dc-Si4db.js";
-import { P as z, S as gt, _ as _t, b as vt, g as yt, h as bt, m as xt, p as St, v as Ct, x as wt, y as Tt, z as Et } from "./chunks/chart-activity-grid-DVOhLgxv.js";
-import { a as Dt, i as Ot, n as kt, o as At, r as jt, t as Mt } from "./chunks/useExplainAI-DJbc7Lu4.js";
-import { a as Nt, c as Pt, i as Ft, l as It, o as Lt, r as Rt, s as zt } from "./chunks/chart-funnel-CkHSXp6h.js";
-import { a as Bt, i as Vt, n as Ht, o as Ut, r as Wt, s as Gt, t as Kt } from "./chunks/charts-loader-0avVzeDd.js";
-import { H as B } from "./chunks/chart-area-C-5ATxvi.js";
+import { A as s, B as c, C as l, E as u, I as d, L as f, M as p, N as m, R as h, S as g, T as _, V as v, _ as y, b, c as x, g as S, j as C, k as w, l as T, s as E, v as D, w as O, x as k, y as A, z as j } from "./chunks/chart-data-table-DoDHQRe7.js";
+import { n as M, r as N } from "./chunks/chart-sankey-D0hhb_EQ.js";
+import { $ as P, A as F, B as I, D as L, E as ee, F as te, G as R, H as ne, I as re, J as ie, K as ae, L as oe, M as se, N as ce, O as le, P as ue, Q as de, R as fe, St as pe, U as me, V as he, W as ge, X as _e, Y as ve, Z as ye, _t as be, a as xe, at as Se, bt as Ce, c as we, ct as Te, dt as Ee, et as De, f as Oe, ft as ke, gt as Ae, h as je, ht as Me, i as Ne, it as Pe, k as Fe, lt as Ie, m as Le, mt as Re, n as ze, o as Be, ot as Ve, p as He, pt as Ue, q as We, r as Ge, st as Ke, t as qe, ut as Je, v as Ye, vt as Xe, w as Ze, xt as Qe, yt as $e, z as et } from "./chunks/DashboardEditModal-BOfLdTgV.js";
+import { S as tt, _ as nt, b as rt, c as it, d as at, f as ot, g as st, h as ct, l as lt, m as ut, o as dt, p as ft, s as pt, v as mt, y as ht } from "./chunks/useDirtyStateTracking-ZfChDEd3.js";
+import { P as z, S as gt, _ as _t, b as vt, g as yt, h as bt, m as xt, p as St, v as Ct, x as wt, y as Tt, z as Et } from "./chunks/chart-activity-grid-4jfS8khG.js";
+import { a as Dt, i as Ot, n as kt, o as At, r as jt, t as Mt } from "./chunks/useExplainAI-im9e1rVb.js";
+import { a as Nt, c as Pt, i as Ft, l as It, o as Lt, r as Rt, s as zt } from "./chunks/chart-funnel-Cd7da_sa.js";
+import { a as Bt, i as Vt, n as Ht, o as Ut, r as Wt, s as Gt, t as Kt } from "./chunks/charts-loader-CwMcOfwT.js";
+import { H as B } from "./chunks/chart-area-Dol6s9no.js";
 import { r as qt } from "./chunks/syntaxHighlighting-Cm43as8i.js";
-import { A as Jt, C as Yt, D as Xt, E as Zt, F as Qt, N as $t, O as en, P as tn, T as nn, _ as rn, a as an, b as on, c as sn, d as cn, f as ln, g as un, h as dn, i as fn, j as pn, k as mn, l as hn, m as gn, n as _n, o as vn, r as yn, s as bn, t as xn, u as Sn, v as Cn, w as wn, x as Tn, y as En } from "./chunks/analysis-builder-shared-l-4WKVS1.js";
-import { r as Dn } from "./chunks/chart-markdown-C0xxBW81.js";
+import { A as Jt, C as Yt, D as Xt, E as Zt, F as Qt, N as $t, O as en, P as tn, T as nn, _ as rn, a as an, b as on, c as sn, d as cn, f as ln, g as un, h as dn, i as fn, j as pn, k as mn, l as hn, m as gn, n as _n, o as vn, r as yn, s as bn, t as xn, u as Sn, v as Cn, w as wn, x as Tn, y as En } from "./chunks/analysis-builder-shared-CEvHIlmk.js";
+import { r as Dn } from "./chunks/chart-markdown-DPE34SjC.js";
 import { t as On } from "./chunks/useNotebookLayout-Ck3Z3uzg.js";
-import { n as kn } from "./chunks/chart-bubble-BFN5WIpf.js";
+import { n as kn } from "./chunks/chart-bubble-BM2BAMSo.js";
 import { i as An, t as jn } from "./chunks/utils-CToHkuhU.js";
 import V, { createContext as Mn, useCallback as H, useContext as Nn, useEffect as U, useMemo as W, useRef as G, useState as K } from "react";
 import { Fragment as q, jsx as J, jsxs as Y } from "react/jsx-runtime";

package/dist/client/providers.js

@@ -1,3 +1,3 @@
 import { n as e, t } from "./chunks/providers-DwQCKdGW.js";
-import { V as n, c as r, s as i } from "./chunks/chart-data-table-SNSqZj9B.js";
+import { V as n, c as r, s as i } from "./chunks/chart-data-table-DoDHQRe7.js";
 export { i as CubeProvider, t as ScrollContainerProvider, n as createCubeClient, r as useCubeContext, e as useScrollContainer };

package/dist/client/schema.js

@@ -1,2 +1,2 @@
-import { t as e } from "./chunks/schema-visualization-CGbnbzj_.js";
+import { t as e } from "./chunks/schema-visualization-C6g_LCiA.js";
 export { e as SchemaVisualization };

package/dist/client/utils.js

@@ -1,8 +1,8 @@
-import { A as e, I as t, N as n, S as r, a as i, i as a, j as o, o as s, r as c } from "./chunks/chart-data-table-SNSqZj9B.js";
-import { A as l, C as u, D as d, E as f, M as p, N as m, O as h, T as g, c as _, d as v, f as y, j as b, k as x, l as S, s as C, u as w, w as T } from "./chunks/chart-activity-grid-DVOhLgxv.js";
-import { B as E, F as D, I as O, L as k, N as A, P as j, R as M, V as N, z as P } from "./chunks/chart-area-C-5ATxvi.js";
+import { A as e, I as t, N as n, S as r, a as i, i as a, j as o, o as s, r as c } from "./chunks/chart-data-table-DoDHQRe7.js";
+import { A as l, C as u, D as d, E as f, M as p, N as m, O as h, T as g, c as _, d as v, f as y, j as b, k as x, l as S, s as C, u as w, w as T } from "./chunks/chart-activity-grid-4jfS8khG.js";
+import { B as E, F as D, I as O, L as k, N as A, P as j, R as M, V as N, z as P } from "./chunks/chart-area-Dol6s9no.js";
 import { a as F, i as I, n as L, r as R, t as z } from "./chunks/syntaxHighlighting-Cm43as8i.js";
-import { _ as B, g as V, h as H, m as U } from "./chunks/chart-kpi-delta-BJCOXE-F.js";
+import { _ as B, g as V, h as H, m as U } from "./chunks/chart-kpi-delta-Dq8qUOOT.js";
 import { a as W, i as G, n as K, o as q, r as J, s as Y, t as X } from "./chunks/utils-CToHkuhU.js";
 import "react";
 import { jsx as Z } from "react/jsx-runtime";