SY-2816: Synnax v0.44.5 (#1387)

Author: emilbon99

console/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@synnaxlabs/console",
   "private": true,
-  "version": "0.44.7",
+  "version": "0.44.8",
   "type": "module",
   "scripts": {
     "check-types": "tsc --noEmit",

console/src/lineplot/SelectAxis.tsx

@@ -40,6 +40,7 @@ export const SelectMultipleAxesInputItem = ({
       initialParams={SEARCH_OPTIONS}
       onChange={useCallback((v: channel.Key[]) => onChange(axis, v), [onChange, axis])}
       full="x"
+      location="top"
       {...selectProps}
     />
   </Input.Item>

docs/site/src/pages/reference/cluster/installation.mdx

@@ -73,21 +73,6 @@ echo 'export PATH=$PATH:/usr/local/bin' >> ~/.zshrc
 If any previous versions of Synnax are installed and available on your `PATH`, you may
 need to remove them to avoid conflicts.
 
-<Note.Note variant="warning">
-If you've also installed the [Synnax Python
-Client](/reference/python-client/get-started), its `synnax` command may take precedence
-over the one you just installed. To avoid conflicts, rename the binary you've just
-installed to something else, like `synnax-server` by running (you may need to use
-`sudo`):
-
-```
-mv /usr/local/bin/synnax /usr/local/bin/synnax-server
-```
-
-Then, you can run the binary using `synnax-server` instead of `synnax`.
-
-</Note.Note>
-
 Next, give execution permissions to the binary:
 
 ```bash
@@ -138,20 +123,6 @@ echo 'export PATH=$PATH:/usr/local/bin' >> ~/.zshrc
 If any previous versions of Synnax are installed and available on your `PATH`, you may
 need to remove them to avoid conflicts.
 
-<Note.Note variant="warning">
-If you've also installed the [Synnax Python
-Client](/reference/python-client/get-started), its `synnax` command may take precedence
-over the one you just installed. To avoid conflicts, rename the binary you've just
-installed to something else, like `synnax-server` by running:
-
-```
-mv /usr/local/bin/synnax /usr/local/bin/synnax-server
-```
-
-Then, you can run the binary using `synnax-server` instead of `synnax`.
-
-</Note.Note>
-
 Next, give execution permissions to the binary:
 
 ```bash
@@ -191,13 +162,6 @@ Install the Synnax cluster on Windows by downloading and running the latest inst
 <br />
 <br />
 
-<Note.Note variant="warning">
-  If you've also installed the [Synnax Python
-  Client](/reference/python-client/get-started), its `synnax` command may take
-  precedence over the one you just installed. You can alternatively use the
-  `synnax-server` command which has also been added to your `PATH`.
-</Note.Note>
-
 To verify that the installation was successful, run the following command in a
 **PowerShell** terminal:
 

docs/site/src/pages/releases/0-43-0.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Version 0.42 Release Notes"
+title: "Version 0.43 Release Notes"
 ---
 
 import Release from "@/components/releases/Release.astro";

docs/site/src/pages/releases/0-44-0.mdx

@@ -0,0 +1,129 @@
+---
+title: "Version 0.44 Release Notes"
+---
+
+import Release from "@/components/releases/Release.astro";
+import { Image, Video } from "@/components/Media";
+import { mdxOverrides } from "@/components/mdxOverrides";
+import { Divider, Flex } from "@synnaxlabs/pluto";
+
+export const components = mdxOverrides;
+
+<Release
+    version="0.44.0"
+    date="Aug 11, 2025"
+    title="Embedded Console"
+>
+
+<Image client:only="react" id="releases/0-44-0/thumbnail" themed={false} />
+
+Synnax v0.44 introduces an embedded Console into the Synnax Cluster, which can be used
+in place of the desktop Console application.
+
+We've also improved the data export process by adding dedicated CSV export buttons to
+both ranges and line plots.
+
+As always, this release comes with a number of additional performance, stability, and
+user experience improvements to Synnax.
+
+<Divider.Divider x />
+
+### Embedded Console
+
+Every Synnax cluster now comes with an embedded, browser-based Console. After starting
+the cluster using the default port of `9090`, you can access the Console at
+`http://localhost:9090`.
+
+All functionality of the desktop Console is available in the embedded Console, with the
+notable exception of multi-window functionality.
+
+The desktop Console will continue to be supported, and it's still our preferred way to
+work with a Synnax deployment.
+
+<Divider.Divider x />
+
+### Data Export
+
+We've added dedicated CSV export buttons to both ranges and line plots, making it much
+easier to export data from Synnax for analysis.
+
+<Flex.Box x justify="center">
+  <Image
+    client:only="react"
+    id="releases/0-44-0/csv"
+    themed={false}
+    style={{ width: 350 }}
+  />
+</Flex.Box>
+
+<Divider.Divider x />
+
+### Legend Y-Axis Indicators
+
+The line plot legend now separates lines to into groups by their corresponding y-axis.
+
+<Flex.Box x justify="center">
+  <Image
+    client:only="react"
+    id="releases/0-44-0/legend"
+    themed={false}
+    style={{ width: 100 }}
+  />
+</Flex.Box>
+
+<Divider.Divider x />
+
+### Added Methods for Reading the Latest Values from a Channel
+
+We've added new methods in the Python and TypeScript clients for reading the most recent
+values written to one or more channels.
+
+##### Python
+
+In Python, simply call `read_latest` with the channels and the number of values you want
+to read. Additional documentation can be found
+[here](/reference/python-client/read-data).
+
+```python
+import synnax as sy
+
+client = sy.Synnax()
+
+print(client.read_latest(["daq_time", "ox_pt_1"], 1))
+# {
+#   "daq_time": [1723200000000000000],
+#   "ox_pt_1": [100.0]
+# }
+```
+
+##### TypeScript
+
+The TypeScript client has a `readLatest` method that works in the same way. Additional
+documentation can be found [here](/reference/typescript-client/read-data).
+
+```typescript
+import { Synnax } from "@synnaxlabs/client";
+
+const client = new Synnax();
+
+console.log(client.readLatest(["daq_time", "ox_pt_1"], 1));
+// {
+//   "daq_time": [1723200000000000000],
+//   "ox_pt_1": [100.0]
+// }
+```
+
+<Divider.Divider x />
+
+### Minor Improvements and Bug Fixes
+
+- Added status indicators for devices and drivers to selection dialogs.
+- Made a number of updates to real-time data fetching infrastructure, improving the
+  reactivity and performance of the cosnole.
+- Added `Command + W` and `Control + W` keyboard shortcuts to close modals, and added a
+  press and hold delay to close the application on MacOS.
+- Fixed an issue where the Palette would not properly switch between command and search
+  modes when closed and re-opened.
+- Added drag and drop importing and exporting of tasks.
+
+</Release>

docs/site/src/pages/releases/index.mdx

@@ -16,11 +16,17 @@ import Release0400 from "@/pages/releases/0-40-0.mdx";
 import Release0410 from "@/pages/releases/0-41-0.mdx";
 import Release0420 from "@/pages/releases/0-42-0.mdx";
 import Release0430 from "@/pages/releases/0-43-0.mdx";
+import Release0440 from "@/pages/releases/0-44-0.mdx";
 import { mdxOverrides } from "@/components/mdxOverrides";
 export const components = mdxOverrides;
 
 import { Divider } from "@synnaxlabs/pluto";
 
+<Divider.Divider x />
+<div class="release-wrapper">
+  ###### 0.44
+  <Release0440 />
+</div>
 <Divider.Divider x />
 <div class="release-wrapper">
   ###### 0.43

pluto/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synnaxlabs/pluto",
-  "version": "0.44.7",
+  "version": "0.44.8",
   "type": "module",
   "scripts": {
     "build": "tsc --noEmit && vite build",

pluto/src/dialog/Frame.tsx

@@ -23,7 +23,7 @@ import {
 import { type Component } from "@/component";
 import { CSS } from "@/css";
 import { BACKGROUND_CLASS } from "@/dialog/Background";
-import { type LocationPreference, position } from "@/dialog/position";
+import { type LocationPreference, position, type Preference } from "@/dialog/position";
 import { Flex } from "@/flex";
 import {
   useClickOutside,
@@ -178,7 +178,7 @@ export const Frame = ({
 
   const visibleRef = useSyncedRef(visible);
   const targetRef = useRef<HTMLDivElement>(null);
-  const prevLocation = useRef<xlocation.XY | undefined>(undefined);
+  const prevLocationPreference = useRef<Preference | undefined>(undefined);
   const prevBox = useRef<box.Box | undefined>(undefined);
   const dialogRef = useRef<HTMLDivElement>(null);
 
@@ -202,17 +202,21 @@ export const Frame = ({
         return { ...prev, modalPosition };
       });
     }
+    let prefer = PREFERENCES;
+    if (prevLocationPreference.current != null)
+      prefer = [prevLocationPreference.current, ...PREFERENCES];
     // In the connected or floating case, we use a more sophisticated positioning
     // algorithm.
-    const { adjustedDialog, targetCorner, dialogCorner } = position({
+    const { adjustedDialog, ...locations } = position({
       target,
       dialog,
       container: windowBox,
-      prefer: PREFERENCES,
+      prefer,
       initial: propsLocation,
       offset: 3,
     });
-    prevLocation.current = targetCorner;
+    prevLocationPreference.current = locations;
+    const { targetCorner, dialogCorner } = locations;
     const roundedDialog = box.round(adjustedDialog);
     if (positionsEqual(variant, roundedDialog, prevBox.current)) return;
     prevBox.current = roundedDialog;