OpenPanel is an open-source web and product analytics platform, an open-source alternative to Mixpanel with optional self-hosting.
/**
* Which side(s) of a series should fade to transparent at the chart edges.
* - `true` → fade both edges
* - `false` → no fade (default for `<Area>`)
* - `"left"` / `"right"` → fade only that side (`"left"` is the default for `<Line>`)
*/
export type FadeEdges = boolean | 'left' | 'right';
export interface FadeSides {
/** Whether the left edge should fade out. */
left: boolean;
/** Whether the right edge should fade out. */
right: boolean;
/** True if either side fades — use to gate gradient/mask defs. */
any: boolean;
}
export function resolveFadeSides(fade: FadeEdges): FadeSides {
if (fade === false) {
return { left: false, right: false, any: false };
}
if (fade === 'left') {
return { left: true, right: false, any: true };
}
if (fade === 'right') {
return { left: false, right: true, any: true };
}
return { left: true, right: true, any: true };
}
export interface FadeGradientStop {
offset: string;
opacity: number;
}
/**
* Stops for a horizontal fade gradient with opacity 0 at the faded side(s)
* and opacity 1 in the middle. Matches the historic 0/15/85/100 pattern.
*/
export function fadeGradientStops(sides: FadeSides): FadeGradientStop[] {
return [
{ offset: '0%', opacity: sides.left ? 0 : 1 },
{ offset: '15%', opacity: 1 },
{ offset: '85%', opacity: 1 },
{ offset: '100%', opacity: sides.right ? 0 : 1 },
];
}
/** Horizontal fade gradient pinned to the chart viewport (not the series path bounds). */
export function viewportFadeGradientAttrs(innerWidth: number) {
return {
gradientUnits: 'userSpaceOnUse' as const,
x1: 0,
x2: innerWidth,
y1: 0,
y2: 0,
};
}