ableton-js 3.4.6 → 3.6.0

package/CHANGELOG.md

@@ -4,8 +4,26 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v3.6.0](https://github.com/leolabs/ableton.js/compare/v3.5.0...v3.6.0)
+
+- :label: Mark all raw object state as readonly [`ace0efd`](https://github.com/leolabs/ableton.js/commit/ace0efde39e5b598dd0a2878e0e29ecffedd495a)
+- :sparkles: Add options to override the caching mechanism [`85405d4`](https://github.com/leolabs/ableton.js/commit/85405d4be89bdc052f53bb862c5fe904620c554a)
+
+#### [v3.5.0](https://github.com/leolabs/ableton.js/compare/v3.4.6...v3.5.0)
+
+> 10 November 2024
+
+- Feature: session highlighting with red ring [`#123`](https://github.com/leolabs/ableton.js/pull/123)
+- Update README to have correct start scripts [`#124`](https://github.com/leolabs/ableton.js/pull/124)
+- :hammer: Add a `format` command and document it in the readme [`b383e44`](https://github.com/leolabs/ableton.js/commit/b383e449692f2c2741fbbd013c87c055716a34e2)
+- :bug: Fix large messages sent by the Python script not being received processed properly by Node [`fd33ce3`](https://github.com/leolabs/ableton.js/commit/fd33ce305521b580f2c87ef72034225e5feaf14d)
+- :bug: Fix larger messages not being received properly in Live [`233296e`](https://github.com/leolabs/ableton.js/commit/233296e054b80b961b5011ebbe1b849cd3cbbd22)
+- :bug: Fix typing for `mute` value [`30f62ee`](https://github.com/leolabs/ableton.js/commit/30f62ee0195a03bdc4bd48e9b0c2ee5a120212d4)
+
 #### [v3.4.6](https://github.com/leolabs/ableton.js/compare/v3.4.5...v3.4.6)
 
+> 18 May 2024
+
 - Get `song.view.get('detail_clip')` working [`#118`](https://github.com/leolabs/ableton.js/pull/118)
 
 #### [v3.4.5](https://github.com/leolabs/ableton.js/compare/v3.4.4...v3.4.5)

package/README.md

@@ -31,8 +31,9 @@ After starting Ableton Live, add the script to your list of control surfaces:
 ![Ableton Live Settings](https://i.imgur.com/a34zJca.png)
 
 If you've forked this project on macOS, you can also use yarn to do that for
-you. Running `yarn ableton:start` will copy the `midi-script` folder, open
-Ableton and show a stream of log messages until you kill it.
+you. Running `yarn ableton10:start` or `yarn ableton11:start` (depending on your
+app version) will copy the `midi-script` folder, open Ableton and show a stream
+of log messages until you kill it.
 
 ## Using Ableton.js
 
@@ -240,3 +241,9 @@ library.
   [Issue #4](https://github.com/leolabs/ableton-js/issues/4)
 - The `playing_status` listener of clip slots never fires in Ableton. See
   [Issue #25](https://github.com/leolabs/ableton-js/issues/25)
+
+## Contributing
+
+If you'd like to add features to this project or submit a bugfix, please feel
+free to open a pull request. Before committing changes to any of the TypeScript
+files, please run `yarn format` to format the code using Prettier.

package/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { EventEmitter } from "events";
 import LruCache from "lru-cache";
 import { Song } from "./ns/song";
@@ -7,6 +6,7 @@ import { Application } from "./ns/application";
 import { Midi } from "./ns/midi";
 import { Cache } from "./util/cache";
 import { Logger } from "./util/logger";
+import { Session } from "./ns/session";
 interface Command {
     uuid: string;
     ns: string;
@@ -82,6 +82,10 @@ export interface AbletonOptions {
      * Options for the response cache.
      */
     cacheOptions?: LruCache.Options<string, any>;
+    /**
+     * Completely disables the cache.
+     */
+    disableCache?: boolean;
     /**
      * Set this to allow ableton-js to log messages. If you set this to
      * `console`, log messages are printed to the standard output.
@@ -98,8 +102,9 @@ export declare class Ableton extends EventEmitter implements ConnectionEventEmit
     private buffer;
     private latency;
     private serverPort;
-    cache: Cache;
+    cache?: Cache;
     song: Song;
+    session: Session;
     application: Application;
     internal: Internal;
     midi: Midi;
@@ -150,7 +155,7 @@ export declare class Ableton extends EventEmitter implements ConnectionEventEmit
      * disconnects, for example.
      */
     removeAllPropListeners(): void;
-    sendRaw(msg: string): void;
+    sendRaw(msg: string): Promise<void>;
     isConnected(): boolean;
 }
 export { getPackageVersion } from "./util/package-version";

package/index.js

@@ -21,6 +21,7 @@ const application_1 = require("./ns/application");
 const midi_1 = require("./ns/midi");
 const package_version_1 = require("./util/package-version");
 const cache_1 = require("./util/cache");
+const session_1 = require("./ns/session");
 const SERVER_PORT_FILE = "ableton-js-server.port";
 const CLIENT_PORT_FILE = "ableton-js-client.port";
 class TimeoutError extends Error {
@@ -55,6 +56,7 @@ class Ableton extends events_1.EventEmitter {
     serverPort;
     cache;
     song = new song_1.Song(this);
+    session = new session_1.Session(this); // added for red session ring control
     application = new application_1.Application(this);
     internal = new internal_1.Internal(this);
     midi = new midi_1.Midi(this);
@@ -67,11 +69,13 @@ class Ableton extends events_1.EventEmitter {
         super();
         this.options = options;
         this.logger = options?.logger;
-        this.cache = new lru_cache_1.default({
-            max: 500,
-            ttl: 1000 * 60 * 10,
-            ...options?.cacheOptions,
-        });
+        if (!options?.disableCache) {
+            this.cache = new lru_cache_1.default({
+                max: 500,
+                ttl: 1000 * 60 * 10,
+                ...options?.cacheOptions,
+            });
+        }
         this.clientPortFile = path_1.default.join(os_1.default.tmpdir(), this.options?.clientPortFile ?? CLIENT_PORT_FILE);
         this.serverPortFile = path_1.default.join(os_1.default.tmpdir(), this.options?.serverPortFile ?? SERVER_PORT_FILE);
     }
@@ -124,7 +128,9 @@ class Ableton extends events_1.EventEmitter {
             return this.waitForConnection();
         }
         this.clientState = "starting";
-        this.client = dgram_1.default.createSocket({ type: "udp4" });
+        // The recvBufferSize is set to macOS' default value, so the
+        // socket behaves the same on Windows and doesn't drop any packets
+        this.client = dgram_1.default.createSocket({ type: "udp4", recvBufferSize: 786896 });
         this.client.addListener("message", this.handleIncoming.bind(this));
         this.client.addListener("listening", async () => {
             const port = this.client?.address().port;
@@ -256,18 +262,26 @@ class Ableton extends events_1.EventEmitter {
     }
     handleIncoming(msg, info) {
         try {
-            const index = msg[0];
-            const message = msg.slice(1);
-            this.buffer[index] = message;
-            // 0xFF signals that the end of the buffer has been reached
-            if (index === 255) {
-                this.handleUncompressedMessage((0, zlib_1.unzipSync)(Buffer.concat(this.buffer.filter((b) => b))).toString());
-                this.buffer = [];
+            const messageId = msg[0];
+            const messageIndex = msg[1];
+            const totalMessages = msg[2];
+            const message = msg.subarray(3);
+            if (messageIndex === 0 && totalMessages === 1) {
+                this.handleUncompressedMessage((0, zlib_1.unzipSync)(message).toString());
+                return;
+            }
+            if (!this.buffer[messageId]) {
+                this.buffer[messageId] = [];
+            }
+            this.buffer[messageId][messageIndex] = message;
+            if (!this.buffer[messageId].includes(undefined) &&
+                this.buffer[messageId].length === totalMessages) {
+                this.handleUncompressedMessage((0, zlib_1.unzipSync)(Buffer.concat(this.buffer[messageId])).toString());
+                delete this.buffer[messageId];
             }
         }
         catch (e) {
             this.buffer = [];
-            this.logger?.warn("Couldn't handle message:", { error: e });
             this.emit("error", e);
         }
     }
@@ -353,7 +367,7 @@ class Ableton extends events_1.EventEmitter {
     async sendCachedCommand(command) {
         const args = command.args?.prop ?? JSON.stringify(command.args);
         const cacheKey = [command.ns, command.nsid, args].filter(Boolean).join("/");
-        const cached = this.cache.get(cacheKey);
+        const cached = this.cache?.get(cacheKey);
         const result = await this.sendCommand({
             ...command,
             etag: cached?.etag,
@@ -369,14 +383,14 @@ class Ableton extends events_1.EventEmitter {
         }
         else {
             if (result.etag) {
-                this.cache.set(cacheKey, result);
+                this.cache?.set(cacheKey, result);
             }
             return result.data;
         }
     }
     async getProp(ns, nsid, prop, cache) {
         const params = { ns, nsid, name: "get_prop", args: { prop } };
-        if (cache) {
+        if (cache && this.cache) {
             return this.sendCachedCommand(params);
         }
         else {
@@ -438,21 +452,24 @@ class Ableton extends events_1.EventEmitter {
     removeAllPropListeners() {
         this.eventListeners.clear();
     }
-    sendRaw(msg) {
+    async sendRaw(msg) {
         if (!this.client || !this.serverPort) {
             throw new Error("The client hasn't been started yet. Please call start() first.");
         }
         const buffer = (0, zlib_1.deflateSync)(Buffer.from(msg));
-        const byteLimit = this.client.getSendBufferSize() - 1;
+        const byteLimit = this.client.getSendBufferSize() - 100;
         const chunks = Math.ceil(buffer.byteLength / byteLimit);
         // Split the message into chunks if it becomes too large
         for (let i = 0; i < chunks; i++) {
             const chunk = Buffer.concat([
                 // Add a counter to the message, the last message is always 255
                 Buffer.alloc(1, i + 1 === chunks ? 255 : i),
-                buffer.slice(i * byteLimit, i * byteLimit + byteLimit),
+                buffer.subarray(i * byteLimit, i * byteLimit + byteLimit),
             ]);
             this.client.send(chunk, 0, chunk.length, this.serverPort, "127.0.0.1");
+            // Add a bit of a delay between sent chunks to reduce the chance of the
+            // receiving buffer filling up which would cause chunks to be discarded.
+            await new Promise((res) => setTimeout(res, 20));
         }
     }
     isConnected() {

package/midi-script/AbletonJS.py

@@ -1,13 +1,13 @@
 from __future__ import absolute_import
 import time
 
-
 from .version import version
 from .Config import DEBUG, FAST_POLLING
 from .Logging import logger
 from .Socket import Socket
 from .Interface import Interface
 from .Application import Application
+from .Session import Session
 from .ApplicationView import ApplicationView
 from .Browser import Browser
 from .BrowserItem import BrowserItem
@@ -32,6 +32,7 @@ import Live
 class AbletonJS(ControlSurface):
     def __init__(self, c_instance):
         super(AbletonJS, self).__init__(c_instance)
+
         logger.info("Starting AbletonJS " + version + "...")
 
         self.tracked_midi = set()
@@ -42,6 +43,8 @@ class AbletonJS(ControlSurface):
         self.handlers = {
             "application": Application(c_instance, self.socket, self.application()),
             "application-view": ApplicationView(c_instance, self.socket, self.application()),
+            # added for red box control
+            "session": Session(c_instance, self.socket, self),
             "browser": Browser(c_instance, self.socket, self.application()),
             "browser-item": BrowserItem(c_instance, self.socket),
             "cue-point": CuePoint(c_instance, self.socket),
@@ -109,6 +112,7 @@ class AbletonJS(ControlSurface):
         super(AbletonJS, self).disconnect()
 
     def command_handler(self, payload):
+
         namespace = payload["ns"]
 
         # Don't clutter the logs

package/midi-script/Session.py

@@ -0,0 +1,42 @@
+from __future__ import absolute_import
+from .Interface import Interface
+from .Logging import logger
+
+from _Framework.SessionComponent import SessionComponent
+
+
+class Session(Interface):
+    def __init__(self, c_instance, socket, controlSurface):
+        super(Session, self).__init__(c_instance, socket)
+
+        self.controlSurface = controlSurface
+        self.sessionComponent = SessionComponent
+
+    def get_ns(self, nsid=None):
+        return self
+
+    def setup_session_box(self, ns, num_tracks=2, num_scenes=2):
+        """
+        Creates the session with the red ring box.
+        """
+        with self.controlSurface.component_guard():
+            logger.info(
+                f"Setting up session box with {num_tracks} tracks and {num_scenes} scenes.")
+            self.session = self.sessionComponent(num_tracks, num_scenes)
+            self.session.set_offsets(0, 0)
+            self.controlSurface.set_highlighting_session_component(
+                self.session)
+            return True
+
+    def set_session_offset(self, ns, track_offset, scene_offset):
+        """
+        Sets the offset of the SessionComponent instance.
+        """
+        logger.info(
+            f"Moving session box offset to {track_offset} and {scene_offset}.")
+
+        if hasattr(self, 'session'):
+            self.session.set_offsets(track_offset, scene_offset)
+        else:
+            logger.error("Session box not set up.")
+        return True

package/midi-script/Socket.py

@@ -36,6 +36,8 @@ class Socket(object):
         self._last_error = ""
         self._socket = None
         self._chunk_limit = None
+        self._message_id = 0
+        self._receive_buffer = bytearray()
 
         self.read_remote_port()
         self.init_socket(True)
@@ -154,14 +156,19 @@ class Socket(object):
         if self._socket == None or self._chunk_limit == None:
             return
 
+        self._message_id = (self._message_id + 1) % 256
+        message_id_byte = struct.pack("B", self._message_id)
+
         if len(compressed) < self._chunk_limit:
-            self._socket.sendto(b'\xFF' + compressed, self._client_addr)
+            self._socket.sendto(message_id_byte + b'\x00\x01' + compressed, self._client_addr)
         else:
             chunks = list(split_by_n(compressed, self._chunk_limit))
             count = len(chunks)
+            count_byte = struct.pack("B", count)
             for i, chunk in enumerate(chunks):
-                count_byte = struct.pack("B", i if i + 1 < count else 255)
-                self._socket.sendto(count_byte + chunk, self._client_addr)
+                logger.info("Sending packet " + str(self._message_id) + " - " + str(i) + "/" + str(count))
+                packet_byte = struct.pack("B", i)
+                self._socket.sendto(message_id_byte + packet_byte + count_byte + chunk, self._client_addr)
 
     def send(self, name, obj=None, uuid=None):
         def jsonReplace(o):
@@ -189,21 +196,18 @@ class Socket(object):
 
     def process(self):
         try:
-            buffer = bytes()
-            num_messages = 0
             while 1:
                 data = self._socket.recv(65536)
                 if len(data) and self.input_handler:
-                    buffer += data[1:]
-                    num_messages += 1
+                    self._receive_buffer.extend(data[1:])
 
                     # \xFF for Live 10 (Python2) and 255 for Live 11 (Python3)
                     if (data[0] == b'\xFF' or data[0] == 255):
-                        unzipped = zlib.decompress(buffer)
+                        packet = self._receive_buffer
+                        self._receive_buffer = bytearray()
+                        unzipped = zlib.decompress(packet)
                         payload = json.loads(unzipped)
                         self.input_handler(payload)
-                        buffer = bytes()
-                        num_messages = 0
 
         except socket.error as e:
             if (e.errno != 35 and e.errno != 10035 and e.errno != 10054):

package/midi-script/version.py

@@ -1 +1 @@
-version = "3.4.6"
+version = "3.6.0"

package/ns/browser-item.d.ts

@@ -1,16 +1,5 @@
 import { Ableton } from "..";
 import { Namespace } from ".";
-export interface RawBrowserItem {
-    id: string;
-    children: RawBrowserItem[];
-    name: string;
-    is_loadable: boolean;
-    is_selected: boolean;
-    is_device: boolean;
-    is_folder: boolean;
-    source: string;
-    uri: string;
-}
 export interface GettableProperties {
     children: RawBrowserItem[];
     is_device: boolean;
@@ -28,6 +17,17 @@ export interface SettableProperties {
 }
 export interface ObservableProperties {
 }
+export interface RawBrowserItem {
+    readonly id: string;
+    readonly children: RawBrowserItem[];
+    readonly name: string;
+    readonly is_loadable: boolean;
+    readonly is_selected: boolean;
+    readonly is_device: boolean;
+    readonly is_folder: boolean;
+    readonly source: string;
+    readonly uri: string;
+}
 export declare class BrowserItem extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     raw: RawBrowserItem;
     constructor(ableton: Ableton, raw: RawBrowserItem);

package/ns/browser.d.ts

@@ -42,7 +42,7 @@ export interface ObservableProperties {
     hotswap_target: BrowserItem;
 }
 export interface RawBrowser {
-    id: string;
+    readonly id: string;
 }
 export declare class Browser extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     constructor(ableton: Ableton);

package/ns/clip-slot.d.ts

@@ -39,12 +39,12 @@ export interface ObservableProperties {
     playing_status: PlayingStatus;
 }
 export interface RawClipSlot {
-    id: string;
-    color: number;
-    has_clip: boolean;
-    is_playing: boolean;
-    is_recording: boolean;
-    is_triggered: boolean;
+    readonly id: string;
+    readonly color: number;
+    readonly has_clip: boolean;
+    readonly is_playing: boolean;
+    readonly is_recording: boolean;
+    readonly is_triggered: boolean;
 }
 /**
  * This class represents an entry in Live's Session view matrix.

package/ns/clip.d.ts

@@ -135,15 +135,15 @@ export interface ObservableProperties {
     warping: boolean;
 }
 export interface RawClip {
-    id: string;
-    name: string;
-    color: number;
-    color_index: number;
-    is_audio_clip: boolean;
-    is_midi_clip: boolean;
-    start_time: number;
-    end_time: number;
-    muted: boolean;
+    readonly id: string;
+    readonly name: string;
+    readonly color: number;
+    readonly color_index: number;
+    readonly is_audio_clip: boolean;
+    readonly is_midi_clip: boolean;
+    readonly start_time: number;
+    readonly end_time: number;
+    readonly muted: boolean;
 }
 /**
  * This class represents an entry in Live's Session view matrix.

package/ns/cue-point.d.ts

@@ -13,9 +13,9 @@ export interface ObservableProperties {
     time: number;
 }
 export interface RawCuePoint {
-    id: string;
-    name: string;
-    time: number;
+    readonly id: string;
+    readonly name: string;
+    readonly time: number;
 }
 export declare class CuePoint extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     raw: RawCuePoint;

package/ns/device-parameter.d.ts

@@ -25,10 +25,10 @@ export interface ObservableProperties {
     value: number;
 }
 export interface RawDeviceParameter {
-    id: string;
-    name: string;
-    value: number;
-    is_quantized: boolean;
+    readonly id: string;
+    readonly name: string;
+    readonly value: number;
+    readonly is_quantized: boolean;
 }
 export declare enum AutomationState {
     None = 0,

package/ns/device.d.ts

@@ -23,10 +23,10 @@ export interface ObservableProperties {
     parameters: string;
 }
 export interface RawDevice {
-    id: string;
-    name: string;
-    type: DeviceType;
-    class_name: string;
+    readonly id: string;
+    readonly name: string;
+    readonly type: DeviceType;
+    readonly class_name: string;
 }
 export declare enum DeviceType {
     AudioEffect = "audio_effect",

package/ns/index.d.ts

@@ -10,7 +10,7 @@ export declare class Namespace<GP, TP, SP, OP> {
         [T in keyof GP]: boolean;
     }>;
     constructor(ableton: Ableton, ns: string, nsid?: string | undefined);
-    get<T extends keyof GP>(prop: T): Promise<T extends keyof TP ? TP[T] : GP[T]>;
+    get<T extends keyof GP>(prop: T, useCache?: boolean): Promise<T extends keyof TP ? TP[T] : GP[T]>;
     set<T extends keyof SP>(prop: T, value: SP[T]): Promise<null>;
     addListener<T extends keyof OP>(prop: T, listener: (data: T extends keyof TP ? TP[T] : OP[T]) => any): Promise<() => Promise<boolean | undefined>>;
     /**

package/ns/index.js

@@ -12,8 +12,8 @@ class Namespace {
         this.ns = ns;
         this.nsid = nsid;
     }
-    async get(prop) {
-        const cache = !!this.cachedProps[prop];
+    async get(prop, useCache) {
+        const cache = useCache ?? !!this.cachedProps[prop];
         const res = await this.ableton.getProp(this.ns, this.nsid, String(prop), cache);
         const transformer = this.transformers[prop];
         if (res !== null && transformer) {

package/ns/scene.d.ts

@@ -30,9 +30,9 @@ export interface ObservableProperties {
     name: string;
 }
 export interface RawScene {
-    color: number;
-    id: string;
-    name: string;
+    readonly color: number;
+    readonly id: string;
+    readonly name: string;
 }
 export declare class Scene extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     raw: RawScene;

package/ns/session.d.ts

@@ -0,0 +1,15 @@
+import { Ableton } from "..";
+import { Namespace } from ".";
+export interface GettableProperties {
+}
+export interface TransformedProperties {
+}
+export interface SettableProperties {
+}
+export interface ObservableProperties {
+}
+export declare class Session extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
+    constructor(ableton: Ableton);
+    setupSessionBox(num_tracks: number, num_scenes: number): Promise<any>;
+    setSessionOffset(track_offset: number, scene_offset: number): Promise<any>;
+}

package/ns/session.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const _1 = require(".");
+class Session extends _1.Namespace {
+    constructor(ableton) {
+        super(ableton, "session", undefined);
+    }
+    async setupSessionBox(num_tracks, num_scenes) {
+        return this.sendCommand("setup_session_box", { num_tracks, num_scenes });
+    }
+    async setSessionOffset(track_offset, scene_offset) {
+        return this.sendCommand("set_session_offset", {
+            track_offset,
+            scene_offset,
+        });
+    }
+}
+exports.Session = Session;

package/ns/track.d.ts

@@ -131,7 +131,7 @@ export interface ObservableProperties {
     input_meter_right: number;
     is_frozen: number;
     is_showing_chains: number;
-    mute: number;
+    mute: boolean;
     muted_via_solo: number;
     name: string;
     output_meter_left: number;
@@ -141,14 +141,14 @@ export interface ObservableProperties {
     solo: boolean;
 }
 export interface RawTrack {
-    id: string;
-    name: string;
-    color: number;
-    color_index: number;
-    is_foldable: boolean;
-    is_grouped: boolean;
-    mute: boolean;
-    solo: boolean;
+    readonly id: string;
+    readonly name: string;
+    readonly color: number;
+    readonly color_index: number;
+    readonly is_foldable: boolean;
+    readonly is_grouped: boolean;
+    readonly mute: boolean;
+    readonly solo: boolean;
 }
 export declare class Track extends Namespace<GettableProperties, TransformedProperties, SettableProperties, ObservableProperties> {
     raw: RawTrack;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ableton-js",
-  "version": "3.4.6",
+  "version": "3.6.0",
   "description": "Control Ableton Live from Node",
   "main": "index.js",
   "author": "Leo Bernard <admin@leolabs.org>",
@@ -27,7 +27,8 @@
     "build:doc": "jsdoc2md --files src/**/*.ts --configure ./jsdoc2md.json > ./API.md",
     "version": "node hooks/prepublish.js && git add midi-script/version.py && auto-changelog -p -l 100 && git add CHANGELOG.md",
     "build": "tsc",
-    "test": "vitest --run --no-threads"
+    "test": "vitest --run --no-threads",
+    "format": "prettier -w src/"
   },
   "devDependencies": {
     "@types/lodash": "^4.14.194",
@@ -37,6 +38,7 @@
     "@types/uuid": "^8.3.0",
     "auto-changelog": "^2.3.0",
     "p-all": "^3",
+    "prettier": "^3.3.3",
     "tsx": "^3.12.7",
     "typescript": "^5.1.3",
     "vitest": "^0.32.4"