azul-sync 1.3.0

package/dist/sourcemap/propertyLoader.js

@@ -0,0 +1,131 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { log } from "../util/log.js";
+const pathClassKey = (segments, className) => `${segments.join("\u0001")}::${className}`;
+export function loadSourcemapPropertyIndex(sourcemapPath) {
+    const resolved = path.resolve(sourcemapPath);
+    if (!fs.existsSync(resolved)) {
+        log.debug(`No sourcemap found at ${resolved}; skipping property merge.`);
+        return null;
+    }
+    let root;
+    try {
+        const raw = fs.readFileSync(resolved, "utf8");
+        root = JSON.parse(raw);
+    }
+    catch (error) {
+        log.warn(`Failed to read sourcemap at ${resolved}: ${error}`);
+        return null;
+    }
+    const byGuid = new Map();
+    const byPathClass = new Map();
+    const visit = (node, currentPath) => {
+        const nodePath = [...currentPath, node.name];
+        if (node.guid) {
+            byGuid.set(node.guid, node);
+        }
+        const key = pathClassKey(nodePath, node.className);
+        const bucket = byPathClass.get(key) ?? [];
+        bucket.push(node);
+        byPathClass.set(key, bucket);
+        for (const child of node.children ?? []) {
+            visit(child, nodePath);
+        }
+    };
+    for (const child of root.children ?? []) {
+        visit(child, []);
+    }
+    return { byGuid, byPathClass };
+}
+export function applySourcemapProperties(instances, index) {
+    if (!index)
+        return 0;
+    let applied = 0;
+    for (const instance of instances) {
+        const match = findNodeForInstance(instance, index);
+        if (!match)
+            continue;
+        const hasProps = match.properties && Object.keys(match.properties).length > 0;
+        const hasAttrs = match.attributes && Object.keys(match.attributes).length > 0;
+        if (!hasProps && !hasAttrs)
+            continue;
+        if (hasProps) {
+            instance.properties = match.properties;
+        }
+        if (hasAttrs) {
+            instance.attributes = match.attributes;
+        }
+        applied += 1;
+    }
+    return applied;
+}
+export function buildInstancesFromSourcemap(sourcemapPath) {
+    const resolved = path.resolve(sourcemapPath);
+    if (!fs.existsSync(resolved)) {
+        log.warn(`Sourcemap not found at ${resolved}`);
+        return null;
+    }
+    let root;
+    try {
+        const raw = fs.readFileSync(resolved, "utf8");
+        root = JSON.parse(raw);
+    }
+    catch (error) {
+        log.error(`Failed to parse sourcemap at ${resolved}: ${error}`);
+        return null;
+    }
+    const results = [];
+    const visit = (node, currentPath, parentGuid) => {
+        const nodePath = [...currentPath, node.name];
+        const guid = node.guid ?? randomUUID().replace(/-/g, "");
+        const instance = {
+            guid,
+            className: node.className,
+            name: node.name,
+            path: nodePath,
+            parentGuid,
+        };
+        if (node.properties)
+            instance.properties = node.properties;
+        if (node.attributes)
+            instance.attributes = node.attributes;
+        const isScript = node.className === "Script" ||
+            node.className === "LocalScript" ||
+            node.className === "ModuleScript";
+        if (isScript && node.filePaths && node.filePaths.length > 0) {
+            const scriptPath = path.resolve(process.cwd(), node.filePaths[0]);
+            try {
+                instance.source = fs.readFileSync(scriptPath, "utf8");
+            }
+            catch (error) {
+                log.warn(`Failed to read script file for ${nodePath.join("/")}: ${error}`);
+            }
+        }
+        results.push(instance);
+        for (const child of node.children ?? []) {
+            visit(child, nodePath, guid);
+        }
+    };
+    for (const child of root.children ?? []) {
+        visit(child, []);
+    }
+    results.sort((a, b) => a.path.length - b.path.length);
+    return results;
+}
+function findNodeForInstance(instance, index) {
+    if (instance.guid) {
+        const byGuid = index.byGuid.get(instance.guid);
+        if (byGuid)
+            return byGuid;
+    }
+    const key = pathClassKey(instance.path, instance.className);
+    const bucket = index.byPathClass.get(key);
+    if (!bucket || bucket.length === 0)
+        return null;
+    if (bucket.length === 1)
+        return bucket[0];
+    // Prefer a node that also carries a guid to reduce ambiguity
+    return bucket.find((node) => Boolean(node.guid)) ?? bucket[0];
+}
+//# sourceMappingURL=propertyLoader.js.map

package/dist/sourcemap/propertyLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyLoader.js","sourceRoot":"","sources":["../../src/sourcemap/propertyLoader.ts"],"names":[],"mappings":"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"}

package/dist/util/id.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generate a unique GUID for tracking instances
+ */
+export declare function generateGUID(): string;
+/**
+ * Validate GUID format
+ */
+export declare function isValidGUID(guid: string): boolean;
+//# sourceMappingURL=id.d.ts.map

package/dist/util/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/util/id.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/util/id.js

@@ -0,0 +1,14 @@
+import { randomBytes } from "crypto";
+/**
+ * Generate a unique GUID for tracking instances
+ */
+export function generateGUID() {
+    return randomBytes(16).toString("hex");
+}
+/**
+ * Validate GUID format
+ */
+export function isValidGUID(guid) {
+    return /^[a-f0-9]{32}$/.test(guid);
+}
+//# sourceMappingURL=id.js.map

package/dist/util/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/util/id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/util/log.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Simple logging utility with color support
+ */
+export declare const log: {
+    info(message: string, ...args: any[]): void;
+    success(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+    userInput(message: string, ...args: any[]): void;
+    script(path: string, action: "created" | "updated" | "deleted"): void;
+};
+//# sourceMappingURL=log.d.ts.map

package/dist/util/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/util/log.ts"],"names":[],"mappings":"AAAA;;GAEG;AAsBH,eAAO,MAAM,GAAG;kBACA,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;qBAS1B,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;kBAShC,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;mBAS5B,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;mBAS7B,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;uBASzB,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI;iBASnC,MAAM,UAAU,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,IAAI;CActE,CAAC"}

package/dist/util/log.js

@@ -0,0 +1,51 @@
+/**
+ * Simple logging utility with color support
+ */
+import { config } from "../config.js";
+const colors = {
+    reset: "\x1b[0m",
+    bright: "\x1b[1m",
+    dim: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+};
+function timestamp() {
+    return new Date().toISOString().slice(11, 23);
+}
+export const log = {
+    info(message, ...args) {
+        console.log(`${colors.dim}[${timestamp()}]${colors.reset} ${colors.blue}ℹ${colors.reset} ${message}`, ...args);
+    },
+    success(message, ...args) {
+        console.log(`${colors.dim}[${timestamp()}]${colors.reset} ${colors.green}✓${colors.reset} ${message}`, ...args);
+    },
+    warn(message, ...args) {
+        console.log(`${colors.dim}[${timestamp()}]${colors.reset} ${colors.yellow}⚠${colors.reset} ${message}`, ...args);
+    },
+    error(message, ...args) {
+        console.error(`${colors.dim}[${timestamp()}]${colors.reset} ${colors.red}✗${colors.reset} ${message}`, ...args);
+    },
+    debug(message, ...args) {
+        if (config.debugMode) {
+            console.log(`${colors.dim}[${timestamp()}] 🔍 ${message}${colors.reset}`, ...args);
+        }
+    },
+    userInput(message, ...args) {
+        console.log(`${colors.dim}[${timestamp()}]${colors.reset} ${colors.cyan}?${colors.reset} ${message}`, ...args);
+    },
+    script(path, action) {
+        const emoji = action === "created" ? "+" : action === "updated" ? "~" : "−";
+        const color = action === "created"
+            ? colors.green
+            : action === "updated"
+                ? colors.yellow
+                : colors.red;
+        console.log(`${colors.dim}[${timestamp()}]${colors.reset} ${color}${emoji}${colors.reset} ${path}`);
+    },
+};
+//# sourceMappingURL=log.js.map

package/dist/util/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/util/log.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "azul-sync",
+  "version": "1.3.0",
+  "description": "Azul is a two-way synchronization tool between Roblox Studio and your local filesystem, with full IntelliSense support.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "azul": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rimraf dist",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "roblox",
+    "studio",
+    "sync",
+    "luau",
+    "lsp",
+    "rojo"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "ws": "^8.16.0",
+    "chokidar": "^3.5.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.5.10",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3"
+  }
+}

package/plugin/README.md

@@ -0,0 +1,54 @@
+# <span><img src="/docs/assets/logo.png" alt="Azul Logo" height="30"></span> Azul Companion Plugin
+
+## Installation
+
+### Method 1: Automatic via Roblox Marketplace (Recommended)
+
+1. Install the plugin automatically using the Roblox Plugin Marketplace: https://create.roblox.com/store/asset/79510309341601/Azul-Companion-Plugin
+
+> If the plugin does not show up, follow the [troubleshooting steps](#troubleshooting).
+
+### Method 2: Manual Install via Place File
+
+1. Download the source code from the [Azul Companion Plugin](https://www.roblox.com/games/132762411481199/Azul-Companion-Plugin) place: (3 dots (⋯) > "Download")
+2. Open the downloaded `.rbxlx` or `.rbxl` file in Roblox Studio
+3. Right-click the `AzulCompanionPlugin` folder in `ReplicatedFirst` and select **"Save as Local Plugin"**
+4. Restart Roblox Studio
+5. The Azul icon should now appear in the toolbar
+
+### Method 3: Build via Azul
+
+In case you wish to help maintain the plugin or want to customize it, you can build the Plugin project yourself using Azul:
+
+```ps1
+cd plugin
+azul build --from-sourcemap .\sourcemap.json
+```
+
+## Troubleshooting
+
+### Plugin not showing up
+
+Roblox is very particular about how plugins are installed. Sometimes, just "getting" the plugin from the marketplace isn't enough. Try the following steps:
+
+1. Restart Roblox Studio
+2. Open any game (or create a new one)
+3. Go to **Toolbox** > **Inventory**<br/>
+   ![alt text](../docs/assets/plugin/toolbox.png)
+4. In the dropdown, select **My Plugins**
+5. Locate the Azul Companion Plugin and click **Install**
+6. The Azul icon should now appear in the toolbar
+
+### Plugin not connecting
+
+- Ensure the daemon is running (run `azul`)
+- Check that `HttpService` is enabled:
+  - Go to **Home** → **Game Settings** → **Security**
+  - Enable **"Allow HTTP Requests"**
+- Verify firewall isn't blocking port 8080
+
+### Scripts not syncing
+
+- Click "Toggle Sync" to reconnect
+- Check the Output window for error messages
+- Restart both the daemon and Studio

package/plugin/sourcemap.json

@@ -0,0 +1,264 @@
+{
+  "name": "Game",
+  "className": "DataModel",
+  "children": [
+    {
+      "name": "ReplicatedFirst",
+      "className": "ReplicatedFirst",
+      "guid": "7204",
+      "children": [
+        {
+          "name": "AzulCompanionPlugin",
+          "className": "Folder",
+          "guid": "9427",
+          "children": [
+            {
+              "name": "Actor",
+              "className": "Actor",
+              "guid": "9401",
+              "children": [
+                {
+                  "name": "AzulSync",
+                  "className": "Script",
+                  "guid": "11066",
+                  "filePaths": [
+                    "sync/ReplicatedFirst/AzulCompanionPlugin/Actor/AzulSync.server.luau"
+                  ],
+                  "properties": {
+                    "RunContext": {
+                      "__type": "EnumItem",
+                      "enumType": "RunContext",
+                      "name": "Plugin"
+                    }
+                  }
+                }
+              ]
+            },
+            {
+              "name": "AzulService",
+              "className": "ModuleScript",
+              "guid": "9574",
+              "filePaths": [
+                "sync/ReplicatedFirst/AzulCompanionPlugin/AzulService.luau"
+              ]
+            },
+            {
+              "name": "Config",
+              "className": "ModuleScript",
+              "guid": "9573",
+              "filePaths": [
+                "sync/ReplicatedFirst/AzulCompanionPlugin/Config.luau"
+              ]
+            },
+            {
+              "name": "Enums",
+              "className": "ModuleScript",
+              "guid": "9572",
+              "filePaths": [
+                "sync/ReplicatedFirst/AzulCompanionPlugin/Enums.luau"
+              ]
+            },
+            {
+              "name": "StudioWidgets",
+              "className": "Folder",
+              "guid": "9428",
+              "children": [
+                {
+                  "name": "Components",
+                  "className": "Folder",
+                  "guid": "9429",
+                  "children": [
+                    {
+                      "name": "CollapsibleTitledSection",
+                      "className": "ModuleScript",
+                      "guid": "9565",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/CollapsibleTitledSection.luau"
+                      ]
+                    },
+                    {
+                      "name": "ColorPicker",
+                      "className": "ModuleScript",
+                      "guid": "9564",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/ColorPicker.luau"
+                      ]
+                    },
+                    {
+                      "name": "CustomTextButton",
+                      "className": "ModuleScript",
+                      "guid": "9562",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/CustomTextButton.luau"
+                      ]
+                    },
+                    {
+                      "name": "DropdownMenu",
+                      "className": "ModuleScript",
+                      "guid": "9569",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/DropdownMenu.luau"
+                      ]
+                    },
+                    {
+                      "name": "HorizontalLine",
+                      "className": "ModuleScript",
+                      "guid": "9568",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/HorizontalLine.luau"
+                      ]
+                    },
+                    {
+                      "name": "ImageButtonWithText",
+                      "className": "ModuleScript",
+                      "guid": "9570",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/ImageButtonWithText.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledCheckbox",
+                      "className": "ModuleScript",
+                      "guid": "9563",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledCheckbox.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledColorInputPicker",
+                      "className": "ModuleScript",
+                      "guid": "9566",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledColorInputPicker.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledMultiChoice",
+                      "className": "ModuleScript",
+                      "guid": "9561",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledMultiChoice.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledNumberInput",
+                      "className": "ModuleScript",
+                      "guid": "9556",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledNumberInput.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledRadioButton",
+                      "className": "ModuleScript",
+                      "guid": "9555",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledRadioButton.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledSlider",
+                      "className": "ModuleScript",
+                      "guid": "9554",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledSlider.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledTextInput",
+                      "className": "ModuleScript",
+                      "guid": "9557",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledTextInput.luau"
+                      ]
+                    },
+                    {
+                      "name": "LabeledToggleButton",
+                      "className": "ModuleScript",
+                      "guid": "9559",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/LabeledToggleButton.luau"
+                      ]
+                    },
+                    {
+                      "name": "StatefulImageButton",
+                      "className": "ModuleScript",
+                      "guid": "9558",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/StatefulImageButton.luau"
+                      ]
+                    },
+                    {
+                      "name": "VerticallyScalingListFrame",
+                      "className": "ModuleScript",
+                      "guid": "9560",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/VerticallyScalingListFrame.luau"
+                      ]
+                    },
+                    {
+                      "name": "VerticalScrollingFrame",
+                      "className": "ModuleScript",
+                      "guid": "9567",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/VerticalScrollingFrame.luau"
+                      ]
+                    },
+                    {
+                      "name": "VerticalSpacer",
+                      "className": "ModuleScript",
+                      "guid": "9571",
+                      "filePaths": [
+                        "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/Components/VerticalSpacer.luau"
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "name": "GuiUtilities",
+                  "className": "ModuleScript",
+                  "guid": "9553",
+                  "filePaths": [
+                    "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/GuiUtilities.luau"
+                  ]
+                },
+                {
+                  "name": "RbxGui",
+                  "className": "ModuleScript",
+                  "guid": "9552",
+                  "filePaths": [
+                    "sync/ReplicatedFirst/AzulCompanionPlugin/StudioWidgets/RbxGui.luau"
+                  ]
+                }
+              ]
+            },
+            {
+              "name": "UI",
+              "className": "ModuleScript",
+              "guid": "9550",
+              "filePaths": [
+                "sync/ReplicatedFirst/AzulCompanionPlugin/UI.luau"
+              ]
+            },
+            {
+              "name": "WebSocketClient",
+              "className": "ModuleScript",
+              "guid": "9551",
+              "filePaths": [
+                "sync/ReplicatedFirst/AzulCompanionPlugin/WebSocketClient.luau"
+              ]
+            }
+          ]
+        }
+      ],
+      "properties": {
+        "Archivable": true
+      }
+    }
+  ],
+  "_azul": {
+    "packVersion": 1,
+    "packedAt": "2026-02-26T23:51:44.029Z",
+    "mode": "all"
+  }
+}