add pane index to price scale api

[illetid]

Type of PR:

PR checklist:

• Addresses an existing issue: fixes [v5] changing priceScale for one pane impact all panes #1817
• Includes tests
• Documentation update

Overview of change:
Added pane index as parameter to get price scale api. And fixed issue with getting correct price scale when series in not on the 1st pane

[github-actions]

size-limit report 📦

Path	Size
ESM	44.92 KB (+0.15% 🔺)
ESM createChart	36.9 KB (+0.14% 🔺)
ESM createChartEx	35.6 KB (-0.04% 🔽)
ESM createYieldCurveChart	37.12 KB (+0.16% 🔺)
ESM createOptionsChart	35.84 KB (+0.14% 🔺)
Standalone-ESM	46.39 KB (+0.05% 🔺)
Standalone	46.31 KB (+0.08% 🔺)
Plugin: Text Watermark	1.87 KB (+0.21% 🔺)
Plugin: Image Watermark	1.69 KB (+0.18% 🔺)
Plugin: Series Markers	3.99 KB (+0.4% 🔺)
Series: LineSeries	2.54 KB (-0.08% 🔽)
Series: BaselineSeries	3.19 KB (-0.1% 🔽)
Series: AreaSeries	3.12 KB (-0.1% 🔽)
Series: BarSeries	2.14 KB (-0.05% 🔽)
Series: CandlestickSeries	2.43 KB (-0.05% 🔽)
Series: HistogramSeries	2.19 KB (+0.27% 🔺)
Plugin: UpDownMarkersPrimitive	2.37 KB (-0.5% 🔽)

[SlicedSilver]

Potentially minor.

The series API has the priceScale() method for getting a price scale API instance for the price scale currently used by the series. However if the series is moved to a different pane (or the panes are swapped) then the instance of the API isn't actually for that specific series anymore.

// areaSeries is on Pane 0
const areaPriceScale = areaSeries.priceScale();
chart.swapPanes(0,1);
// areaSeries is now on Pane 1
areaPriceScale.applyOptions({
	textColor: 'yellow'
}); // ← This applies to Pane 0, and thus not the price scale currently used by the area series.

Not saying that this behaviour is wrong but rather that we should at least mention it in the JSDoc comment so it is clearer. It currently says:

/**
 * Returns interface of the price scale the series is currently attached
 *
 * @returns IPriceScaleApi object to control the price scale
 */
priceScale(): IPriceScaleApi;

Perhaps we should mention (warn) that the price scale api returned is for the current price scale used by the series (id and pane index) and if the series is moved or starts to use a different id then this interface want to changed to the new price scale.

[illetid]

@SlicedSilver updated the jsdoc, could you take a look pls