@octanejs/recharts 0.1.40 → 0.1.42

package/src/util/{useUniqueId.js → useUniqueId.ts}

@@ -1,5 +1,4 @@
-// Vendored verbatim from recharts@3.9.2 es6/util/useUniqueId.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
+// Adapted from recharts@3.9.2, commit b3451050c027a23957ffa50a2665c9119df21e47.
 import { useId } from './useId';
 
 /**
@@ -12,12 +11,12 @@ import { useId } from './useId';
  * @param [customId] - An optional custom ID to override the generated one.
  * @returns The unique ID.
  */
-export function useUniqueId(prefix, customId) {
+export function useUniqueId(prefix?: string, customId?: string): string {
 	/*
 	 * We have to call this hook here even if we don't use the result because
 	 * rules of hooks demand that hooks are never called conditionally.
 	 */
-	var generatedId = useId();
+	const generatedId = useId();
 
 	// If a custom ID is provided, it always takes precedence.
 	if (customId) {
@@ -25,10 +24,15 @@ export function useUniqueId(prefix, customId) {
 	}
 
 	// Apply the prefix if one was provided.
-	return prefix ? ''.concat(prefix, '-').concat(generatedId) : generatedId;
+	return prefix ? `${prefix}-${generatedId}` : generatedId;
 }
 
 /**
  * The useUniqueId hook returns a unique ID that is either reused from external props or generated internally.
  * Either way the ID is now guaranteed to be present so no more nulls or undefined.
  */
+export type WithIdRequired<T> = T & {
+	id: string;
+};
+
+export type WithoutId<T> = Omit<T, 'id'>;

package/src/zIndex/{DefaultZIndexes.js → DefaultZIndexes.ts}

@@ -1,11 +1,10 @@
-// Vendored verbatim from recharts@3.9.2 es6/zIndex/DefaultZIndexes.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
+// Adapted from recharts@3.9.2, commit b3451050c027a23957ffa50a2665c9119df21e47.
 /**
  * A collection of all default zIndex values used by Recharts.
  *
  * You can reuse these, or you can define your own.
  */
-export var DefaultZIndexes = {
+export const DefaultZIndexes = {
 	/**
 	 * CartesianGrid and PolarGrid
 	 */
@@ -15,6 +14,7 @@ export var DefaultZIndexes = {
 	 * This is not visible by default but can be enabled by setting background={true} on Bar or RadialBar.
 	 */
 	barBackground: -50,
+
 	/*
 	 * other chart elements or custom elements without specific zIndex
 	 * render in here, at zIndex 0
@@ -24,6 +24,7 @@ export var DefaultZIndexes = {
 	 * Area, Pie, Radar, and ReferenceArea
 	 */
 	area: 100,
+
 	/**
 	 * Cursor is embedded inside Tooltip and controlled by it.
 	 * The Tooltip itself has a separate portal and is not included in the zIndex system;
@@ -31,27 +32,33 @@ export var DefaultZIndexes = {
 	 * It renders below bar so that in a stacked bar chart the cursor rectangle does not hide the other bars.
 	 */
 	cursorRectangle: 200,
+
 	/**
 	 * Bar and RadialBar
 	 */
 	bar: 300,
+
 	/**
 	 * Line and ReferenceLine, and ErrorBor
 	 */
 	line: 400,
+
 	/**
 	 * XAxis and YAxis and PolarAngleAxis and PolarRadiusAxis ticks and lines and children
 	 */
 	axis: 500,
+
 	/**
 	 * Scatter and ReferenceDot,
 	 * and Dots of Line and Area and Radar if they have dot=true
 	 */
 	scatter: 600,
+
 	/**
 	 * Hovering over a Bar or RadialBar renders a highlight rectangle
 	 */
 	activeBar: 1000,
+
 	/**
 	 * Cursor is embedded inside Tooltip and controlled by it.
 	 * The Tooltip itself has a separate portal and is not included in the zIndex system;
@@ -64,12 +71,14 @@ export var DefaultZIndexes = {
 	 * This also applies to the radial cursor in RadialBarChart.
 	 */
 	cursorLine: 1100,
+
 	/**
 	 * Hovering over a Point in Line, Area, Scatter, Radar renders a highlight dot
 	 */
 	activeDot: 1200,
+
 	/**
 	 * LabelList and Label, including Axis labels
 	 */
 	label: 2000,
-};
+} as const satisfies Record<string, number>;

package/src/zIndex/ZIndexLayer.tsrx

@@ -1,3 +1,12 @@
+import type { OctaneNode } from '../util/OctaneTypes.ts';
+
+export interface ZIndexable {
+	zIndex?: number;
+}
+type ZIndexLayerProps = {
+	zIndex: number | undefined;
+	children?: OctaneNode;
+};
 // Port of zIndex/ZIndexLayer.tsx — renders children into the redux-registered
 // <g> for the given zIndex via an octane portal (SVG has no CSS z-index).
 // Registration is deferred-cleanup: while a zIndex changes, the old portal
@@ -10,7 +19,7 @@ import { useIsInChartContext } from '../context/chartLayoutContext.ts';
 import { useIsPanorama } from '../context/PanoramaContext.ts';
 
 /** @since 3.4 */
-export function ZIndexLayer(props) {
+export function ZIndexLayer(props: ZIndexLayerProps) {
 	const { zIndex, children } = props;
 	// Outside a chart there is no zIndex portal state — render normally.
 	const isInChartContext = useIsInChartContext();
@@ -20,10 +29,10 @@ export function ZIndexLayer(props) {
 
 	// Deferred-cleanup bookkeeping: every registered zIndex, plus the last valid
 	// portal node to keep rendering into during a zIndex transition.
-	const lastPortalElementRef = useRef(undefined);
-	const registeredZIndexesRef = useRef(new Set());
+	const lastPortalElementRef = useRef<Element | undefined>(undefined);
+	const registeredZIndexesRef = useRef(new Set<number>());
 	const dispatch = useAppDispatch();
-	const portalElement = useAppSelector(
+	const portalElement: Element | undefined = useAppSelector(
 		(state) => selectZIndexPortalElement(state, zIndex, isPanorama),
 	);
 

package/src/zIndex/ZIndexPortal.tsrx

@@ -1,3 +1,5 @@
+import type { OctaneNode } from '../util/OctaneTypes.ts';
+
 // Port of zIndex/ZIndexPortal.tsx — SVG cannot use CSS z-index, so recharts
 // renders one <g> per registered zIndex (negatives before the default layer,
 // positives after) and ZIndexLayer portals content into them.
@@ -6,9 +8,12 @@ import { useAppDispatch, useAppSelector } from '../state/hooks';
 import { registerZIndexPortalElement, unregisterZIndexPortalElement } from '../state/zIndexSlice';
 import { selectAllRegisteredZIndexes } from './zIndexSelectors';
 
-function ZIndexSvgPortal(props) {
+function ZIndexSvgPortal(props: {
+	zIndex: number;
+	isPanorama: boolean;
+}) {
 	const { zIndex, isPanorama } = props;
-	const ref = useRef(null);
+	const ref = useRef<SVGGElement | null>(null);
 	const dispatch = useAppDispatch();
 	useLayoutEffect(() => {
 		if (ref.current) {
@@ -22,9 +27,14 @@ function ZIndexSvgPortal(props) {
 	return <g tabIndex={-1} ref={ref} className={'recharts-zIndex-layer_' + zIndex}></g>;
 }
 
-export function AllZIndexPortals(props) @{
+export function AllZIndexPortals(props: {
+	children?: OctaneNode;
+	isPanorama: boolean;
+}) @{
 	const { children, isPanorama } = props;
-	const allRegisteredZIndexes = useAppSelector(selectAllRegisteredZIndexes);
+	const allRegisteredZIndexes: ReadonlyArray<number> | undefined = useAppSelector(
+		selectAllRegisteredZIndexes,
+	);
 	if (!allRegisteredZIndexes || allRegisteredZIndexes.length === 0) {
 		return children;
 	}

package/src/zIndex/{getZIndexFromUnknown.js → getZIndexFromUnknown.ts}

@@ -1,7 +1,7 @@
-// Vendored verbatim from recharts@3.9.2 es6/zIndex/getZIndexFromUnknown.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
+// Adapted from recharts@3.9.2, commit b3451050c027a23957ffa50a2665c9119df21e47.
 import { isWellBehavedNumber } from '../util/isWellBehavedNumber';
-export function getZIndexFromUnknown(input, defaultZIndex) {
+
+export function getZIndexFromUnknown(input: unknown, defaultZIndex: number): number {
 	if (
 		input &&
 		typeof input === 'object' &&

package/src/zIndex/{zIndexSelectors.js → zIndexSelectors.ts}

@@ -1,7 +1,8 @@
-// Vendored verbatim from recharts@3.9.2 es6/zIndex/zIndexSelectors.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
+// Adapted from recharts@3.9.2, commit b3451050c027a23957ffa50a2665c9119df21e47.
 import { createSelector } from 'reselect';
+import { RechartsRootState } from '../state/store';
 import { arrayContentsAreEqualCheck } from '../state/selectors/arrayEqualityCheck';
+
 import { DefaultZIndexes } from './DefaultZIndexes';
 
 /**
@@ -10,15 +11,19 @@ import { DefaultZIndexes } from './DefaultZIndexes';
  *
  * It also returns undefined in case the z-index portal has not been rendered yet.
  */
-export var selectZIndexPortalElement = createSelector(
-	(state) => state.zIndex.zIndexMap,
-	(_, zIndex) => zIndex,
-	(_, _zIndex, isPanorama) => isPanorama,
+export const selectZIndexPortalElement: (
+	state: RechartsRootState,
+	zIndex: number | undefined,
+	isPanorama: boolean,
+) => Element | undefined = createSelector(
+	(state: RechartsRootState) => state.zIndex.zIndexMap,
+	(_: RechartsRootState, zIndex: number | undefined) => zIndex,
+	(_: RechartsRootState, _zIndex: number | undefined, isPanorama: boolean) => isPanorama,
 	(zIndexMap, zIndex, isPanorama) => {
 		if (zIndex == null) {
 			return undefined;
 		}
-		var entry = zIndexMap[zIndex];
+		const entry = zIndexMap[zIndex];
 		if (entry == null) {
 			return undefined;
 		}
@@ -28,13 +33,14 @@ export var selectZIndexPortalElement = createSelector(
 		return entry.element;
 	},
 );
-export var selectAllRegisteredZIndexes = createSelector(
-	(state) => state.zIndex.zIndexMap,
+
+export const selectAllRegisteredZIndexes = createSelector(
+	(state: RechartsRootState) => state.zIndex.zIndexMap,
 	(zIndexMap) => {
-		var allNumbers = Object.keys(zIndexMap)
+		const allNumbers = Object.keys(zIndexMap)
 			.map((zIndexStr) => parseInt(zIndexStr, 10))
 			.concat(Object.values(DefaultZIndexes));
-		var uniqueNumbers = Array.from(new Set(allNumbers));
+		const uniqueNumbers = Array.from(new Set(allNumbers));
 		return uniqueNumbers.sort((a, b) => a - b);
 	},
 	{

package/src/animation/easing.js

@@ -1,193 +0,0 @@
-// Vendored verbatim from recharts@3.9.2 es6/animation/easing.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
-export var ACCURACY = 1e-4;
-var cubicBezierFactor = (c1, c2) => [0, 3 * c1, 3 * c2 - 6 * c1, 3 * c1 - 3 * c2 + 1];
-var evaluatePolynomial = (params, animationElapsedTime) =>
-	params.map((param, i) => param * animationElapsedTime ** i).reduce((pre, curr) => pre + curr);
-var cubicBezier = (c1, c2) => (animationElapsedTime) => {
-	var params = cubicBezierFactor(c1, c2);
-	return evaluatePolynomial(params, animationElapsedTime);
-};
-var derivativeCubicBezier = (c1, c2) => (animationElapsedTime) => {
-	var params = cubicBezierFactor(c1, c2);
-	var newParams = [...params.map((param, i) => param * i).slice(1), 0];
-	return evaluatePolynomial(newParams, animationElapsedTime);
-};
-var parseCubicBezier = (easing) => {
-	var _easingParts$;
-	var easingParts = easing.split('(');
-	if (easingParts.length !== 2 || easingParts[0] !== 'cubic-bezier') {
-		return null;
-	}
-	var numbers =
-		(_easingParts$ = easingParts[1]) === null ||
-		_easingParts$ === void 0 ||
-		(_easingParts$ = _easingParts$.split(')')[0]) === null ||
-		_easingParts$ === void 0
-			? void 0
-			: _easingParts$.split(',');
-	if (numbers == null || numbers.length !== 4) {
-		return null;
-	}
-	var coords = numbers.map((x) => parseFloat(x));
-	return [coords[0], coords[1], coords[2], coords[3]];
-};
-var getBezierCoordinates = function getBezierCoordinates() {
-	for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-		args[_key] = arguments[_key];
-	}
-	if (args.length === 1) {
-		switch (args[0]) {
-			case 'linear':
-				return [0.0, 0.0, 1.0, 1.0];
-			case 'ease':
-				return [0.25, 0.1, 0.25, 1.0];
-			case 'ease-in':
-				return [0.42, 0.0, 1.0, 1.0];
-			case 'ease-out':
-				return [0.42, 0.0, 0.58, 1.0];
-			case 'ease-in-out':
-				return [0.0, 0.0, 0.58, 1.0];
-			default: {
-				var easing = parseCubicBezier(args[0]);
-				if (easing) {
-					return easing;
-				}
-			}
-		}
-	}
-	if (args.length === 4) {
-		return args;
-	}
-
-	// Fallback for invalid inputs. The previous implementation was buggy and would lead to NaN.
-	// Returning linear easing is a safe default.
-	return [0.0, 0.0, 1.0, 1.0];
-};
-var createBezierEasing = (x1, y1, x2, y2) => {
-	var curveX = cubicBezier(x1, x2);
-	var curveY = cubicBezier(y1, y2);
-	var derCurveX = derivativeCubicBezier(x1, x2);
-	var rangeValue = (value) => {
-		if (value > 1) {
-			return 1;
-		}
-		if (value < 0) {
-			return 0;
-		}
-		return value;
-	};
-	var bezier = (_animationElapsedTime) => {
-		var animationElapsedTime = _animationElapsedTime > 1 ? 1 : _animationElapsedTime;
-		var x = animationElapsedTime;
-		for (var i = 0; i < 8; ++i) {
-			var evalT = curveX(x) - animationElapsedTime;
-			var derVal = derCurveX(x);
-			if (Math.abs(evalT - animationElapsedTime) < ACCURACY || derVal < ACCURACY) {
-				return curveY(x);
-			}
-			x = rangeValue(x - evalT / derVal);
-		}
-		return curveY(x);
-	};
-	bezier.isStepper = false;
-	return bezier;
-};
-
-// calculate cubic-bezier using Newton's method
-export var configBezier = function configBezier() {
-	return createBezierEasing(...getBezierCoordinates(...arguments));
-};
-/**
- * Creates a performance-optimized, progress-based spring easing function.
- * It pre-calculates ("bakes") spring physics frames upfront based on a fixed duration,
- * then returns a pure, lightweight function mapping progress (0 to 1) to the animated position.
- * This approach is ideal for low-power devices because it removes heavy physics math from the frame loop.
- */
-export var createSpringEasing = function createSpringEasing() {
-	var config = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-	var _config$stiff = config.stiff,
-		stiff = _config$stiff === void 0 ? 100 : _config$stiff,
-		_config$damping = config.damping,
-		damping = _config$damping === void 0 ? 8 : _config$damping,
-		_config$dt = config.dt,
-		dt = _config$dt === void 0 ? 16.67 : _config$dt;
-	var destX = 1;
-	var positions = [0];
-	var currX = 0;
-	var currV = 0;
-
-	// Safety valve to prevent accidental infinite loops if physics config is extreme
-	var maxIterations = 10000;
-	var iterations = 0;
-
-	// 1. Run the simulation until the spring completely stops moving
-	while (iterations < maxIterations) {
-		var FSpring = -(currX - destX) * stiff;
-		var FDamping = currV * damping;
-		currV += ((FSpring - FDamping) * dt) / 1000;
-		currX += (currV * dt) / 1000;
-		positions.push(currX);
-
-		// Stop only when position is essentially at 1.0 AND bounce velocity has died down
-		if (Math.abs(currX - destX) < ACCURACY && Math.abs(currV) < ACCURACY) {
-			break;
-		}
-		iterations++;
-	}
-
-	// Force the absolute final element to be exactly 1.0 for a perfect finish
-	positions[positions.length - 1] = destX;
-	var maxIndex = positions.length - 1;
-
-	// 2. The ultra-smooth runtime function mapping your 0..1 progress
-	return (t) => {
-		var _positions$index, _positions, _positions$index2;
-		if (t <= 0) return 0;
-		if (t >= 1) return destX;
-
-		// Scale t (0..1) proportionally across our entire pre-calculated array
-		var exactFrame = t * maxIndex;
-		var index = Math.floor(exactFrame);
-		var fraction = exactFrame - index;
-
-		// Blend between the two closest frames
-		return (
-			((_positions$index = positions[index]) !== null && _positions$index !== void 0
-				? _positions$index
-				: 0) +
-			(((_positions = positions[index + 1]) !== null && _positions !== void 0 ? _positions : 0) -
-				((_positions$index2 = positions[index]) !== null && _positions$index2 !== void 0
-					? _positions$index2
-					: 0)) *
-				fraction
-		);
-	};
-};
-
-/**
- * @inline
- */
-
-export var createEasingFunction = (easing) => {
-	if (typeof easing === 'string') {
-		switch (easing) {
-			case 'ease':
-			case 'ease-in-out':
-			case 'ease-out':
-			case 'ease-in':
-			case 'linear':
-				return configBezier(easing);
-			case 'spring':
-				return createSpringEasing();
-			default:
-				if (easing.split('(')[0] === 'cubic-bezier') {
-					return configBezier(easing);
-				}
-		}
-	}
-	if (typeof easing === 'function') {
-		return easing;
-	}
-	return null;
-};

package/src/animation/timeoutController.js

@@ -1,49 +0,0 @@
-// Vendored verbatim from recharts@3.9.2 es6/animation/timeoutController.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
-/**
- * Callback type for the timeout function.
- * Receives current time as an argument.
- */
-
-/**
- * A function that, when called, cancels the timeout.
- *
- * @since 3.9
- */
-
-/**
- * TimeoutController is responsible for controlling the movement of time.
- * Think of it as a clock.
- *
- * Recharts default implementation uses requestAnimationFrame which works great in a browser.
- * You may choose to override this which is especially useful if you want to control animations.
- *
- * Why would you want to do this?
- * - unit tests
- * - animations based on something other than time: UI controls, page scroll, mouse movement ...
- *
- * @see {@link https://recharts.github.io/en-US/guide/animations/ Animation guide}
- *
- * @since 3.9
- */
-
-export class RequestAnimationFrameTimeoutController {
-	setTimeout(callback) {
-		var delay = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
-		var startTime = performance.now();
-		var requestId = null;
-		var executeCallback = (now) => {
-			if (now - startTime >= delay) {
-				callback(now);
-			} else {
-				requestId = requestAnimationFrame(executeCallback);
-			}
-		};
-		requestId = requestAnimationFrame(executeCallback);
-		return () => {
-			if (requestId != null) {
-				cancelAnimationFrame(requestId);
-			}
-		};
-	}
-}

package/src/animation/util.js

@@ -1,11 +0,0 @@
-// Vendored verbatim from recharts@3.9.2 es6/animation/util.js (framework-agnostic).
-// Do not edit — update by re-vendoring when the recharts devDependency moves.
-/*
- * @description: convert camel case to dash case
- * string => string
- */
-export var getDashCase = (name) => name.replace(/([A-Z])/g, (v) => '-'.concat(v.toLowerCase()));
-export var getTransitionVal = (props, duration, easing) =>
-	props
-		.map((prop) => ''.concat(getDashCase(prop), ' ').concat(duration, 'ms ').concat(easing))
-		.join(',');