@graphysdk/viz-engine 0.0.1-experimental.6 → 0.0.1-experimental.8

package/dist/index.d.ts

@@ -473,6 +473,16 @@ export declare type BackgroundSpec = {
 
 declare function bar(options?: GeomOptions<'bar'>): LayerInputOf<'bar'>;
 
+/**
+ * Which side of the value scale's domain a bar's baseline (its zero origin) falls beyond.
+ *
+ * - `'min'`: the baseline sits below the domain, so bars grow from the clipped lower edge
+ *   (the usual case — a positive `domainMin`).
+ * - `'max'`: the baseline sits above the domain.
+ * - `null`: the baseline is in view, so bars start at their true origin.
+ */
+export declare type BarBaselineClip = 'min' | 'max' | null;
+
 /**
  * Bar/Column-specific parameters — intentionally empty. A bar's geometry comes
  * entirely from the position columns (band edges plus bar length); corner radius
@@ -3108,6 +3118,16 @@ export declare function getAlpha(observation: Observation): NumericDataValue;
  */
 export declare function getAngleExtent(observation: Observation): AngleExtent;
 
+/**
+ * Reports whether a bar geom's baseline falls outside the value scale's visible domain. When it
+ * does, bar lengths are truncated at the panel edge and no longer encode their values to scale, so
+ * renderers can fade the clipped edge to signal the truncation.
+ *
+ * Returns `null` for non-continuous or reversed value scales, where a single clipped edge is not
+ * well defined.
+ */
+export declare const getBarBaselineClip: (valueScale: CompiledScale | undefined) => BarBaselineClip;
+
 /**
  * Normalized data-space bounds for a bar observation in [0, 1]² with origin at the top-left
  * (matches SVG conventions used by overlay renderers). Negative values flip the rect upside-down

package/dist/index.mjs

@@ -11,7 +11,7 @@ import "@graphysdk/i18n";
 import { curveCatmullRom as Aa, curveLinear as Ta, area as Ma, line as xs, arc as La } from "d3-shape";
 import { Delaunay as Va } from "d3-delaunay";
 import Ea from "lodash-es/isEqual";
-typeof window < "u" && (window.__GRAPHY_SDK__ ??= {}, window.__GRAPHY_SDK__.vizEngine = "0.0.1-experimental.6");
+typeof window < "u" && (window.__GRAPHY_SDK__ ??= {}, window.__GRAPHY_SDK__.vizEngine = "0.0.1-experimental.8");
 const mn = (e) => e.length > 0;
 function h(e) {
   return e != null;
@@ -7357,7 +7357,13 @@ const Ag = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
     dashOffset: nh(s, c),
     arrowheadExtent: d
   };
-}, sh = (e, t) => Math.min(e, t * e / rh), oh = 2, Wo = (e) => e === "catmull-rom" ? Aa : Ta, Lg = (e) => {
+}, sh = (e, t) => Math.min(e, t * e / rh), Lg = (e) => {
+  if (!e || e.kind !== "position" || e.spec.scaleType !== "continuous" || e.spec.reverse) return null;
+  const t = e.domain[0], n = e.domain[e.domain.length - 1];
+  if (typeof t != "number" || typeof n != "number") return null;
+  const r = 0;
+  return t > r ? "min" : n < r ? "max" : null;
+}, oh = 2, Wo = (e) => e === "catmull-rom" ? Aa : Ta, Vg = (e) => {
   switch (e) {
     case "dashed":
       return "8 4";
@@ -7366,7 +7372,7 @@ const Ag = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
     case "solid":
       return;
   }
-}, Vg = (e, t) => t.lineWidth !== "auto" ? t.lineWidth : Pa(e) ?? oh, Eg = (e, t) => {
+}, Eg = (e, t) => t.lineWidth !== "auto" ? t.lineWidth : Pa(e) ?? oh, kg = (e, t) => {
   const n = Wo(t.interpolate), r = Ma().curve(n), s = xs().curve(n);
   if (e.mainAxis === "y") {
     const o = (c) => Ee(C(c) ?? 0), a = (c) => be(c) ?? 0, i = (c) => ie(c) ?? G(c) ?? 0;
@@ -7380,7 +7386,7 @@ const Ag = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
     r.defined(o), s.defined(o);
   }
   return { lineGenerator: s, areaGenerator: r };
-}, kg = (e, t) => t !== "connect" ? e : e.filter((n) => G(n) !== null && C(n) !== null), Ig = (e, t) => {
+}, Ig = (e, t) => t !== "connect" ? e : e.filter((n) => G(n) !== null && C(n) !== null), Cg = (e, t) => {
   const n = be(t), r = ie(t), s = se(t), o = H(t) ?? C(t);
   if (n === null || r === null || s === null || o === null) return null;
   if (e === "x") {
@@ -7389,16 +7395,16 @@ const Ag = ({ guides: e, numberFormat: t, layer: n, locale: r }) => {
   }
   let a = n, i = r - n;
   return i < 0 && (a += i, i = -i), { x: a, y: 1 - o, width: i, height: o - s };
-}, Cg = (e) => {
+}, Dg = (e) => {
   const t = xs().x((n) => G(n) ?? 0).y((n) => Ee(C(n) ?? 0)).curve(Wo(e.interpolate));
   return e.missingValues === "gap" && t.defined((n) => G(n) !== null && C(n) !== null), t;
-}, Dg = (e, t) => t !== "connect" ? e : e.filter((n) => G(n) !== null && C(n) !== null), ah = La(), Fg = (e) => ah(e), _g = (e, t, n) => {
+}, Fg = (e, t) => t !== "connect" ? e : e.filter((n) => G(n) !== null && C(n) !== null), ah = La(), _g = (e) => ah(e), Rg = (e, t, n) => {
   const r = Mn(e, t);
   return (s) => {
     const o = Ie(s) ?? "default", a = r(s);
     return `${n}-${o}${a !== null && a !== "" ? `-${a}` : ""}`;
   };
-}, Rg = () => (e, t) => fn(e) ?? `default-${t}`;
+}, Ng = () => (e, t) => fn(e) ?? `default-${t}`;
 function Yo(e, t) {
   return Xn(e.buckets, t, (n) => n.main);
 }
@@ -7932,7 +7938,7 @@ function Wh({ layer: e, cursor: t, aspectRatio: n, warmStarts: r }) {
   }
 }
 const mt = { primary: null, group: [], related: /* @__PURE__ */ new Map() }, Yh = 1;
-class Ng {
+class Pg {
   constructor({ layers: t, coordSystem: n }) {
     this.layerIndexes = [], this.layerRefs = [], this.aspectRatio = Yh, this.warmStarts = /* @__PURE__ */ new Map(), this.cachedState = mt, this.cachedKey = null, this.nonInteractiveLayerIds = /* @__PURE__ */ new Set(), this.layerIndexes = t.map((r) => ps(r, n, this.aspectRatio)), this.layerRefs = t.map((r) => ms(r, n)), this.nonInteractiveLayerIds = fs(t);
   }
@@ -8030,7 +8036,7 @@ function fs(e) {
 function Hh(e, t) {
   return e.data === t.data && e.geom === t.geom && e.position === t.position && e.coord === t.coord;
 }
-function Pg(e, t) {
+function Og(e, t) {
   const n = Ue(e.mainAxis, t);
   if (e.mainAxis === "y") {
     const s = Me(Ee(n));
@@ -8039,7 +8045,7 @@ function Pg(e, t) {
   const r = Me(n);
   return { x1: r, x2: r, y1: 0, y2: "100%" };
 }
-function Og(e, t, n) {
+function $g(e, t, n) {
   const r = e.mainAxis === "y" ? C(n.observation) : G(n.observation);
   if (r === null) return null;
   const s = e.mainAxis === "y" ? Kh(n) : Uh(n), a = (t.x?.kind === "position" ? t.x : null)?.bandwidth ?? s;
@@ -8060,7 +8066,7 @@ function Kh(e) {
   const t = se(e.observation), n = H(e.observation);
   return t === null || n === null ? null : n - t;
 }
-const Xh = /^(?:https?:|mailto:)/i, $g = (e) => {
+const Xh = /^(?:https?:|mailto:)/i, Bg = (e) => {
   if (typeof e != "string") return !1;
   const t = e.replace(/^[\x00-\x20]+/, "");
   return t.length === 0 ? !1 : Xh.test(t);
@@ -8134,7 +8140,7 @@ const Xh = /^(?:https?:|mailto:)/i, $g = (e) => {
       throw new Error(`Unhandled value format: ${n.type}`);
     }
   }
-}, Bg = ({
+}, zg = ({
   layers: e,
   coordSystem: t,
   scales: n,
@@ -8231,10 +8237,10 @@ function ny(e, t) {
   const n = Qe(t.yScaleType);
   return Kn(e, n)?.label ?? "";
 }
-const zg = (e) => ({
+const Gg = (e) => ({
   type: "annotations",
   annotations: e
-}), Gg = {
+}), Wg = {
   lilac: "linear-gradient(94deg, #C9C0F7 -2.94%, #F6E6FD 92.51%)",
   neon_pink: "linear-gradient(93deg, #E04A95 2.61%, #FD7F92 97.51%)",
   blackberry: "linear-gradient(132deg, #9F9FED 2.98%, #B9E6FF 97.65%)",
@@ -8248,7 +8254,7 @@ const zg = (e) => ({
   cool: "linear-gradient(93.55deg, #3F8EEB -6.07%, #58C8D8 113.6%)",
   fresh: "linear-gradient(114.37deg, #A4A4EE 4.32%, #58C8D8 87.71%)"
 };
-function Wg(e, t = {}) {
+function Yg(e, t = {}) {
   return {
     type: "highlight",
     id: t.id,
@@ -8257,7 +8263,7 @@ function Wg(e, t = {}) {
     layerIndex: t.layerIndex
   };
 }
-function Yg(...e) {
+function Hg(...e) {
   let t = {}, n;
   const [r, ...s] = e;
   h(r) && !ry(r) ? (t = r, n = s) : n = e;
@@ -8271,7 +8277,7 @@ function Yg(...e) {
   };
   return n.reduce((a, i) => Ko(a, i), o);
 }
-function Hg(e, ...t) {
+function Ug(e, ...t) {
   return t.reduce((n, r) => Ko(n, r), e);
 }
 function ry(e) {
@@ -8315,7 +8321,7 @@ function sy(e, t) {
 function de(e, t) {
   return e ? t ? [...e, ...t] : e : t;
 }
-function Ug(e) {
+function Kg(e) {
   return {
     mapping: e.mapping,
     layers: e.layers,
@@ -8952,7 +8958,7 @@ L.register(wy);
 L.register(Ay);
 L.register(Ty);
 L.register(My);
-class Kg {
+class Xg {
   constructor(t = {}) {
     this.undoStack = [], this.redoStack = [], this.listeners = /* @__PURE__ */ new Set(), this.isEmitting = !1, this.cachedSnapshot = null, this.maxHistorySize = t.maxHistorySize ?? 100;
   }
@@ -9059,11 +9065,11 @@ const Xo = 500, jo = "normal", qo = {
   heavy: 900,
   extraBlack: 950,
   ultraBlack: 950
-}, Xg = (e) => {
+}, jg = (e) => {
   const t = e.style ?? jo, n = e.weight ?? Xo, r = e.family.includes(",") ? e.family : `'${e.family}'`;
   return `${t} ${n} ${e.size}px ${r}`;
-}, jg = (e) => typeof e == "string" ? e : Qo(e), Qo = (e) => e.text !== void 0 ? e.text : e.content ? e.content.map(Qo).join("") : "", Zo = (e) => typeof e != "string" ? e ?? Xo : qo[e], Ry = "\0";
-class qg {
+}, qg = (e) => typeof e == "string" ? e : Qo(e), Qo = (e) => e.text !== void 0 ? e.text : e.content ? e.content.map(Qo).join("") : "", Zo = (e) => typeof e != "string" ? e ?? Xo : qo[e], Ry = "\0";
+class Qg {
   constructor(t) {
     this.inner = t, this.cache = /* @__PURE__ */ new Map();
   }
@@ -9175,7 +9181,7 @@ const Ny = {
   "}": 0.33,
   "~": 0.56
 }, Py = 0.55, Oy = 1.05, $y = 0.84, By = 0.21;
-class Qg {
+class Zg {
   measureText(t, n) {
     let r = 0;
     for (const i of t)
@@ -9192,11 +9198,11 @@ class Qg {
 }
 export {
   Bu as BORDER_PRESETS,
-  Gg as BORDER_PRESET_GRADIENTS,
+  Wg as BORDER_PRESET_GRADIENTS,
   lg as COMPILER_STAGE_KEYS,
-  qg as CachedTextMeasurer,
+  Qg as CachedTextMeasurer,
   _y as CommandRegistry,
-  Kg as CommandStackManager,
+  Xg as CommandStackManager,
   zp as Compiler,
   jo as DEFAULT_FONT_STYLE,
   Xo as DEFAULT_FONT_WEIGHT,
@@ -9209,8 +9215,8 @@ export {
   Hf as HEADLINE_TREND_GAP,
   Yf as HEADLINE_TREND_ICON_SIZE,
   Wf as HEADLINE_VALUE_LABEL_GAP,
-  Qg as HeuristicTextMeasurer,
-  Ng as HoverEngine,
+  Zg as HeuristicTextMeasurer,
+  Pg as HoverEngine,
   _o as LAYOUT_PADDING,
   mg as LayoutCompiler,
   nu as MONO_BASES,
@@ -9227,39 +9233,39 @@ export {
   gr as SetScaleDomainCommand,
   pp as SpecResolver,
   ge as VISUAL_VARIABLES,
-  zg as annotations,
+  Gg as annotations,
   fg as buildAverageLineSymbols,
   gg as buildDataLabelsContent,
-  Xg as buildFontString,
+  jg as buildFontString,
   zo as buildLayerYValueFormatter,
-  Fg as buildPolarBarArcPath,
-  Bg as buildTooltipContent,
+  _g as buildPolarBarArcPath,
+  zg as buildTooltipContent,
   L as commandRegistry,
   bg as computeDifferenceArrow,
   vg as computeDirectLabelsLayout,
   Mg as computeFreeformArrow,
   zu as config,
-  Ug as convertSpecToInput,
+  Kg as convertSpecToInput,
   z as coord,
   ag as createAlphaValueReader,
-  Eg as createAreaPathGenerators,
+  kg as createAreaPathGenerators,
   Al as createColorValueReader,
   ug as createCompiler,
   El as createEmptyHighlight,
   ig as createGroupValueReader,
   Tg as createHeadlineItemRows,
   sg as createLabelValueReader,
-  Cg as createLinePathGenerator,
+  Dg as createLinePathGenerator,
   ee as createRawValueReader,
   Vn as createSegmentYReader,
   og as createSizeValueReader,
-  Yg as createSpec,
-  _g as createStableKeyGenerator,
+  Hg as createSpec,
+  Rg as createStableKeyGenerator,
   cg as createStrokeWidthValueReader,
   P as createValueFormatter,
   Mn as createXValueReader,
   wl as createYValueReader,
-  jg as extractPlainText,
+  qg as extractPlainText,
   Kn as findAxisGuide,
   wg as findLegendForAesthetic,
   xg as formatHeadline,
@@ -9268,21 +9274,22 @@ export {
   F as geom,
   rg as getAlpha,
   lf as getAngleExtent,
-  Ig as getBarRectBounds,
+  Lg as getBarBaselineClip,
+  Cg as getBarRectBounds,
   fn as getColor,
   Hn as getCrossAxisCoordinate,
   Wo as getCurve,
-  Lg as getDashArray,
+  Vg as getDashArray,
   Co as getDifferenceArrowDimensions,
   Ie as getGroup,
-  Pg as getHoverGuideLineProps,
-  Og as getHoverGuideRectProps,
+  Og as getHoverGuideLineProps,
+  $g as getHoverGuideRectProps,
   Oa as getLineType,
   Ue as getMainAxisCoordinate,
   Zo as getNumericWeight,
   uf as getRadiusExtent,
   Na as getSize,
-  Rg as getStablePolarBarKeyGenerator,
+  Ng as getStablePolarBarKeyGenerator,
   Pa as getStrokeWidth,
   G as getX,
   ie as getXMax,
@@ -9291,7 +9298,7 @@ export {
   H as getYMax,
   se as getYMin,
   Ra as getYRaw,
-  Wg as highlight,
+  Yg as highlight,
   hg as isCartesian,
   wi as isCategoricalValueFormat,
   tg as isCompilerCachingEnabled,
@@ -9302,19 +9309,19 @@ export {
   dg as isLayerOf,
   Si as isLookupValueFormat,
   ks as isNumericValueFormat,
-  $g as isSafeUrl,
+  Bg as isSafeUrl,
   J as isStackedPosition,
   je as isTemporalValueFormat,
   ng as mapping,
-  Hg as pipe,
+  Ug as pipe,
   A as prefixInternalVariable,
-  kg as prepareAreaObservations,
-  Dg as prepareLineObservations,
+  Ig as prepareAreaObservations,
+  Fg as prepareLineObservations,
   Uh as readXExtent,
   Kh as readYExtent,
   pg as resolveHeadlinePlacement,
   Ln as resolveSegmentYSource,
-  Vg as resolveStrokeWidth,
+  Eg as resolveStrokeWidth,
   Qe as resolveYScaleAesthetic,
   Ve as scale,
   eg as setCompilerCachingEnabled,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@graphysdk/viz-engine",
   "author": "Graphy",
-  "version": "0.0.1-experimental.6",
+  "version": "0.0.1-experimental.8",
   "private": false,
   "type": "module",
   "sideEffects": [
@@ -44,8 +44,8 @@
     "vite": "^6.4.2",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.0",
-    "@graphytools/eslint-plugin-graphy": "1.0.0",
     "@graphytools/eslint-config": "0.0.1",
+    "@graphytools/eslint-plugin-graphy": "1.0.0",
     "@graphytools/vitest-config": "1.0.0",
     "@graphytools/typescript-config": "0.0.1"
   },