finish plotlyjs 2.28 parity

AGENTS.md

@@ -6,7 +6,7 @@ Guidance for AI coding agents working in the Plotly.NET repo. This is a first dr
 
 Plotly.NET is an interactive charting library for .NET, built on top of plotly.js. The core is written in F# and wraps the plotly.js JSON schema with multiple API layers (high-level type-safe `Chart` API down to low-level object manipulation). See [README.md](README.md) for user-facing docs and the [F1000Research paper](https://doi.org/10.12688/f1000research.123971.1) for design rationale.
 
-Currently targeted plotly.js version: **2.27.1** (bundled at [src/Plotly.NET/plotly-2.27.1.min.js](src/Plotly.NET/plotly-2.27.1.min.js)).
+Currently targeted plotly.js version: **2.28.0** (bundled at [src/Plotly.NET/plotly-2.28.0.min.js](src/Plotly.NET/plotly-2.28.0.min.js)).
 
 ## Packages (monorepo layout)
 

Plotly.NET.sln

@@ -1,11 +1,12 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio Version 17
-VisualStudioVersion = 17.0.31903.59
+# Visual Studio Version 18
+VisualStudioVersion = 18.5.11709.299 stable
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "project", "project", "{BF60BC93-E09B-4E5F-9D85-95A519479D54}"
 	ProjectSection(SolutionItems) = preProject
 		.editorconfig = .editorconfig
+		AGENTS.md = AGENTS.md
 		CITATION.cff = CITATION.cff
 		.config\dotnet-tools.json = .config\dotnet-tools.json
 		LICENSE = LICENSE
@@ -135,9 +136,9 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "04_distribution-charts", "0
 		docs\distribution-charts\histograms.fsx = docs\distribution-charts\histograms.fsx
 		docs\distribution-charts\pareto-chart.fsx = docs\distribution-charts\pareto-chart.fsx
 		docs\distribution-charts\point-density.fsx = docs\distribution-charts\point-density.fsx
+		docs\distribution-charts\residual.fsx = docs\distribution-charts\residual.fsx
 		docs\distribution-charts\splom.fsx = docs\distribution-charts\splom.fsx
 		docs\distribution-charts\violin-plots.fsx = docs\distribution-charts\violin-plots.fsx
-		docs\distribution-charts\residual.fsx = docs\distribution-charts\residual.fsx
 	EndProjectSection
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "01_chart-layout", "01_chart-layout", "{C7D0EF67-9A18-49DD-AC79-944E384BD8D0}"
@@ -169,6 +170,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "00_general", "00_general",
 		docs\general\chart-config.fsx = docs\general\chart-config.fsx
 		docs\general\defaults.fsx = docs\general\defaults.fsx
 		docs\general\display-options.fsx = docs\general\display-options.fsx
+		docs\general\encoded-arrays.fsx = docs\general\encoded-arrays.fsx
 		docs\general\image-export.fsx = docs\general\image-export.fsx
 		docs\general\multi-arguments.fsx = docs\general\multi-arguments.fsx
 		docs\general\styling-markers.fsx = docs\general\styling-markers.fsx

docs/3D-charts/3d-isosurface-plots.fsx

@@ -10,8 +10,8 @@ index: 7
 (*** hide ***)
 
 (*** condition: prepare ***)
-#r "nuget: Newtonsoft.JSON, 13.0.1"
-#r "nuget: DynamicObj, 2.0.0"
+#r "nuget: Newtonsoft.JSON, 13.0.3"
+#r "nuget: DynamicObj, 7.0.1"
 #r "nuget: Giraffe.ViewEngine, 1.4.0"
 #r "../../src/Plotly.NET/bin/Release/netstandard2.0/Plotly.NET.dll"
 

docs/_head.html

@@ -20,6 +20,6 @@
 <meta name="twitter:image" content="{{root}}img/logo_meta_tags.png">
 
 <link rel="shortcut icon" type="image/x-icon" href="{{root}}/img/favicon.ico">
-<script src="https://cdn.plot.ly/plotly-2.27.1.min.js"></script>
+<script src="https://cdn.plot.ly/plotly-2.28.0.min.js"></script>
 <script>MathJax = { tex: { inlineMath: [['$', '$'], ['\\(', '\\)']] } };</script>
 <script src="https://cdn.jsdelivr.net/npm/mathjax@3.2.0/es5/tex-svg.js"></script>

docs/categorical-charts/sankey.fsx

@@ -79,3 +79,31 @@ sankey1
 (***hide***)
 sankey1 |> GenericChart.toChartHTML
 (***include-it-raw***)
+
+(**
+## Node alignment
+
+The `NodeAlign` parameter controls how nodes are aligned horizontally. The available options are
+`Left`, `Right`, `Center`, and `Justify` (the default).
+
+Use the `NodeAlign` parameter on `Chart.Sankey` to apply alignment via the convenience overload,
+or pass `Align` to `SankeyNodes.init` directly when building nodes manually:
+*)
+
+let sankeyAligned =
+    Chart.Sankey(
+        nodeLabels = [ "Source A"; "Source B"; "Sink" ],
+        linkedNodeIds = [ 0, 2; 1, 2 ],
+        linkValues = [ 8; 4 ],
+        NodeAlign = StyleParam.SankeyNodeAlign.Left,
+        UseDefaults = false
+    )
+
+(*** condition: ipynb ***)
+#if IPYNB
+sankeyAligned
+#endif // IPYNB
+
+(***hide***)
+sankeyAligned |> GenericChart.toChartHTML
+(***include-it-raw***)