roport 1.0.0

package/README.md

@@ -0,0 +1,32 @@
+# Roport CLI
+
+The companion server for the **Roport** Roblox plugin. This tool enables two-way syncing between Visual Studio Code and Roblox Studio.
+
+## Installation
+
+Install globally using npm:
+
+```bash
+npm install -g roport
+```
+
+## Usage
+
+Navigate to your project directory (where your `.meta.json` files are) and run:
+
+```bash
+roport serve
+```
+
+This will start a local server on port `3456` (default).
+
+## Options
+
+- `-p, --port <number>`: Specify a custom port (default: 3456).
+
+## Setup with Roblox
+
+1. Install this CLI tool.
+2. Install the **Roport** plugin in Roblox Studio.
+3. Start the server with `roport serve`.
+4. Connect via the plugin in Roblox Studio.

package/bin/roport.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const { startServer } = require('../src/server');
+
+program
+  .name('roport')
+  .description('Roport Sync Tool for Roblox')
+  .version('1.0.0');
+
+program
+  .command('serve')
+  .description('Start the sync server')
+  .option('-p, --port <number>', 'Port to run on', '3456')
+  .action((options) => {
+    startServer(parseInt(options.port));
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "roport",
+  "version": "1.0.0",
+  "description": "A sync server for Roblox development. Works with the Roport Roblox Plugin.",
+  "main": "src/server.js",
+  "bin": {
+    "roport": "./bin/roport.js"
+  },
+  "scripts": {
+    "start": "node bin/roport.js serve"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Rydaguy101/RojoExportPlugin.git"
+  },
+  "keywords": [
+    "roblox",
+    "rojo",
+    "sync",
+    "plugin",
+    "development"
+  ],
+  "author": "Rydaguy101",
+  "license": "MIT",
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "express": "^4.18.2",
+    "fs-extra": "^11.1.1",
+    "body-parser": "^1.20.2",
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2"
+  }
+}

package/src/server/RojoSyncPlugin.server.luau

@@ -0,0 +1,914 @@
+local HttpService = game:GetService("HttpService")
+local RunService = game:GetService("RunService")
+local TweenService = game:GetService("TweenService")
+local ScriptEditorService = game:GetService("ScriptEditorService")
+
+-- Prevent running as a normal script
+if not plugin then return end
+
+local TOOLBAR_NAME = "Rojo Tools"
+local BUTTON_NAME = "Open Sync Panel"
+local SERVER_URL_PING = "http://127.0.0.1:3456/ping"
+local SERVER_URL_WRITE = "http://127.0.0.1:3456/write"
+local SERVER_URL_BATCH = "http://127.0.0.1:3456/batch"
+local SERVER_URL_DELETE = "http://127.0.0.1:3456/delete"
+local SERVER_URL_POLL = "http://127.0.0.1:3456/poll"
+
+-- Colors & Styling
+local COLORS = {
+	BG = Color3.fromRGB(37, 37, 37),
+	HEADER = Color3.fromRGB(45, 45, 45),
+	BUTTON = Color3.fromRGB(55, 55, 55),
+	BUTTON_HOVER = Color3.fromRGB(65, 65, 65),
+	ACCENT = Color3.fromRGB(0, 122, 204), -- VS Code Blue
+	TEXT = Color3.fromRGB(245, 245, 245),
+	SUBTEXT = Color3.fromRGB(180, 180, 180),
+	SUCCESS = Color3.fromRGB(90, 200, 90),
+	ERROR = Color3.fromRGB(220, 80, 80),
+	WARNING = Color3.fromRGB(220, 200, 80)
+}
+
+-- State
+local state = {
+	isConnected = false,
+	isAutoSync = false,
+	isAutoPull = false,
+	trackedInstances = {},
+	pathCache = {}, -- [Instance] = "full/path/to/file.ext"
+	connections = {} -- [Instance] = {Connection, ...}
+}
+
+-- UI Elements
+local toolbar = plugin:CreateToolbar(TOOLBAR_NAME)
+-- Note: You must upload icon.png to Roblox and replace "rbxassetid://0" with the actual Asset ID to see the logo.
+local toggleButton
+local success, err = pcall(function()
+	toggleButton = toolbar:CreateButton(BUTTON_NAME, "Open the Rojo Sync Panel", "rbxassetid://0")
+end)
+
+if not success then
+	warn("Roport: Failed to create toolbar button (it might already exist): " .. tostring(err))
+	return
+end
+
+local widgetInfo = DockWidgetPluginGuiInfo.new(
+	Enum.InitialDockState.Right,
+	false, false, 300, 250, 250, 200
+)
+
+local widget = plugin:CreateDockWidgetPluginGui("RojoSyncPanel", widgetInfo)
+widget.Title = "Rojo Sync"
+widget.ZIndexBehavior = Enum.ZIndexBehavior.Sibling
+
+-- Main Frame
+local mainFrame = Instance.new("Frame")
+mainFrame.Size = UDim2.new(1, 0, 1, 0)
+mainFrame.BackgroundColor3 = COLORS.BG
+mainFrame.BorderSizePixel = 0
+mainFrame.Parent = widget
+
+-- Toast Container (ZIndex 10)
+local toastContainer = Instance.new("Frame")
+toastContainer.Size = UDim2.new(1, -20, 1, -20)
+toastContainer.Position = UDim2.new(0, 10, 0, 10)
+toastContainer.BackgroundTransparency = 1
+toastContainer.ZIndex = 10
+toastContainer.Parent = mainFrame
+
+local toastLayout = Instance.new("UIListLayout")
+toastLayout.VerticalAlignment = Enum.VerticalAlignment.Bottom
+toastLayout.HorizontalAlignment = Enum.HorizontalAlignment.Center
+toastLayout.Padding = UDim.new(0, 5)
+toastLayout.Parent = toastContainer
+
+-- Modal Container (ZIndex 20)
+local modalContainer = Instance.new("Frame")
+modalContainer.Size = UDim2.new(1, 0, 1, 0)
+modalContainer.BackgroundColor3 = Color3.new(0, 0, 0)
+modalContainer.BackgroundTransparency = 1 -- Starts invisible
+modalContainer.Visible = false
+modalContainer.ZIndex = 20
+modalContainer.Parent = mainFrame
+
+-- Content Layout
+local contentFrame = Instance.new("Frame")
+contentFrame.Size = UDim2.new(1, 0, 1, 0)
+contentFrame.BackgroundTransparency = 1
+contentFrame.Parent = mainFrame
+
+local listLayout = Instance.new("UIListLayout")
+listLayout.Padding = UDim.new(0, 10)
+listLayout.HorizontalAlignment = Enum.HorizontalAlignment.Center
+listLayout.SortOrder = Enum.SortOrder.LayoutOrder
+listLayout.Parent = contentFrame
+
+local padding = Instance.new("UIPadding")
+padding.PaddingTop = UDim.new(0, 15)
+padding.PaddingLeft = UDim.new(0, 15)
+padding.PaddingRight = UDim.new(0, 15)
+padding.Parent = contentFrame
+
+-- UI Helpers
+local function createCorner(parent, radius)
+	local corner = Instance.new("UICorner")
+	corner.CornerRadius = UDim.new(0, radius or 6)
+	corner.Parent = parent
+	return corner
+end
+
+local function showToast(message, type)
+	local toast = Instance.new("Frame")
+	toast.Size = UDim2.new(1, 0, 0, 0) -- Animate height
+	toast.BackgroundTransparency = 1
+	toast.ClipsDescendants = true
+	toast.Parent = toastContainer
+	
+	local inner = Instance.new("Frame")
+	inner.Size = UDim2.new(1, 0, 0, 35)
+	inner.BackgroundColor3 = COLORS.HEADER
+	inner.BorderSizePixel = 0
+	createCorner(inner, 6)
+	inner.Parent = toast
+	
+	local bar = Instance.new("Frame")
+	bar.Size = UDim2.new(0, 4, 1, 0)
+	bar.BackgroundColor3 = type == "error" and COLORS.ERROR or (type == "success" and COLORS.SUCCESS or COLORS.ACCENT)
+	createCorner(bar, 6)
+	bar.Parent = inner
+	
+	local label = Instance.new("TextLabel")
+	label.Size = UDim2.new(1, -15, 1, 0)
+	label.Position = UDim2.new(0, 10, 0, 0)
+	label.BackgroundTransparency = 1
+	label.Text = message
+	label.TextColor3 = COLORS.TEXT
+	label.Font = Enum.Font.SourceSans
+	label.TextSize = 14
+	label.TextXAlignment = Enum.TextXAlignment.Left
+	label.Parent = inner
+	
+	-- Animation
+	local tweenInfo = TweenInfo.new(0.3, Enum.EasingStyle.Quad, Enum.EasingDirection.Out)
+	TweenService:Create(toast, tweenInfo, {Size = UDim2.new(1, 0, 0, 40)}):Play()
+	
+	task.delay(3, function()
+		local out = TweenService:Create(toast, tweenInfo, {Size = UDim2.new(1, 0, 0, 0)})
+		out:Play()
+		out.Completed:Connect(function() toast:Destroy() end)
+	end)
+end
+
+local function showModal(title, message, onConfirm)
+	modalContainer.Visible = true
+	TweenService:Create(modalContainer, TweenInfo.new(0.3), {BackgroundTransparency = 0.5}):Play()
+	
+	-- Clear previous
+	for _, c in ipairs(modalContainer:GetChildren()) do c:Destroy() end
+	
+	local box = Instance.new("Frame")
+	box.Size = UDim2.new(0.8, 0, 0, 140)
+	box.Position = UDim2.new(0.5, 0, 0.5, 0)
+	box.AnchorPoint = Vector2.new(0.5, 0.5)
+	box.BackgroundColor3 = COLORS.HEADER
+	createCorner(box, 8)
+	box.Parent = modalContainer
+	
+	-- Scale up animation
+	local uiScale = Instance.new("UIScale")
+	uiScale.Scale = 0.8
+	uiScale.Parent = box
+	
+	TweenService:Create(uiScale, TweenInfo.new(0.3, Enum.EasingStyle.Back), {Scale = 1}):Play()
+	
+	local titleLbl = Instance.new("TextLabel")
+	titleLbl.Size = UDim2.new(1, 0, 0, 40)
+	titleLbl.BackgroundTransparency = 1
+	titleLbl.Text = title
+	titleLbl.Font = Enum.Font.SourceSansBold
+	titleLbl.TextSize = 18
+	titleLbl.TextColor3 = COLORS.TEXT
+	titleLbl.Parent = box
+	
+	local msgLbl = Instance.new("TextLabel")
+	msgLbl.Size = UDim2.new(1, -20, 0, 50)
+	msgLbl.Position = UDim2.new(0, 10, 0, 40)
+	msgLbl.BackgroundTransparency = 1
+	msgLbl.Text = message
+	msgLbl.Font = Enum.Font.SourceSans
+	msgLbl.TextSize = 14
+	msgLbl.TextColor3 = COLORS.SUBTEXT
+	msgLbl.TextWrapped = true
+	msgLbl.Parent = box
+	
+	local btnFrame = Instance.new("Frame")
+	btnFrame.Size = UDim2.new(1, -20, 0, 35)
+	btnFrame.Position = UDim2.new(0, 10, 1, -45)
+	btnFrame.BackgroundTransparency = 1
+	btnFrame.Parent = box
+	
+	local layout = Instance.new("UIListLayout")
+	layout.FillDirection = Enum.FillDirection.Horizontal
+	layout.Padding = UDim.new(0, 10)
+	layout.HorizontalAlignment = Enum.HorizontalAlignment.Center
+	layout.Parent = btnFrame
+	
+	local function makeBtn(text, color, cb)
+		local btn = Instance.new("TextButton")
+		btn.Size = UDim2.new(0.45, 0, 1, 0)
+		btn.BackgroundColor3 = color
+		btn.Text = text
+		btn.TextColor3 = COLORS.TEXT
+		btn.Font = Enum.Font.SourceSansBold
+		btn.TextSize = 14
+		createCorner(btn, 4)
+		btn.Parent = btnFrame
+		btn.MouseButton1Click:Connect(cb)
+	end
+	
+	makeBtn("Connect", COLORS.ACCENT, function()
+		TweenService:Create(modalContainer, TweenInfo.new(0.2), {BackgroundTransparency = 1}):Play()
+		modalContainer.Visible = false
+		onConfirm()
+	end)
+	
+	makeBtn("Cancel", COLORS.BUTTON, function()
+		TweenService:Create(modalContainer, TweenInfo.new(0.2), {BackgroundTransparency = 1}):Play()
+		modalContainer.Visible = false
+	end)
+end
+
+-- Components
+local function createButton(text, icon, callback)
+	local btn = Instance.new("TextButton")
+	btn.Size = UDim2.new(1, 0, 0, 40)
+	btn.BackgroundColor3 = COLORS.BUTTON
+	btn.Text = ""
+	createCorner(btn, 6)
+	btn.Parent = contentFrame
+	
+	local lbl = Instance.new("TextLabel")
+	lbl.Size = UDim2.new(1, 0, 1, 0)
+	lbl.BackgroundTransparency = 1
+	lbl.Text = text
+	lbl.Font = Enum.Font.SourceSansBold
+	lbl.TextSize = 16
+	lbl.TextColor3 = COLORS.TEXT
+	lbl.Parent = btn
+	
+	btn.MouseButton1Click:Connect(callback)
+	return btn
+end
+
+-- Status Header
+local statusFrame = Instance.new("Frame")
+statusFrame.Size = UDim2.new(1, 0, 0, 30)
+statusFrame.BackgroundTransparency = 1
+statusFrame.LayoutOrder = 0
+statusFrame.Parent = contentFrame
+
+local statusDot = Instance.new("Frame")
+statusDot.Size = UDim2.new(0, 10, 0, 10)
+statusDot.Position = UDim2.new(0, 0, 0.5, -5)
+statusDot.BackgroundColor3 = COLORS.ERROR
+createCorner(statusDot, 10)
+statusDot.Parent = statusFrame
+
+local statusText = Instance.new("TextLabel")
+statusText.Size = UDim2.new(1, -20, 1, 0)
+statusText.Position = UDim2.new(0, 20, 0, 0)
+statusText.BackgroundTransparency = 1
+statusText.Text = "Disconnected"
+statusText.Font = Enum.Font.SourceSans
+statusText.TextSize = 14
+statusText.TextColor3 = COLORS.SUBTEXT
+statusText.TextXAlignment = Enum.TextXAlignment.Left
+statusText.Parent = statusFrame
+
+-- Helper Functions (Global)
+local function sanitize(name)
+	return name:gsub("[\\/:*?\"<>|]", "_")
+end
+
+local function getPath(inst)
+	local p = {}
+	local c = inst
+	local s = nil
+	while c and c~=game do
+		if c==game:GetService("ServerScriptService") then s="src/server" break
+		elseif c==game:GetService("ReplicatedStorage") then s="src/shared" break
+		elseif c==game:GetService("StarterPlayer").StarterPlayerScripts then s="src/client" break
+		elseif c==game:GetService("Workspace") then s="src/workspace" break
+		elseif c==game:GetService("StarterGui") then s="src/interface" break
+		elseif c==game:GetService("StarterPack") then s="src/tools" break
+		elseif c==game:GetService("Lighting") then s="src/lighting" break
+		elseif c==game:GetService("ReplicatedFirst") then s="src/first" break
+		elseif c==game:GetService("SoundService") then s="src/sounds" break
+		end
+		table.insert(p,1,(sanitize(c.Name)))
+		c=c.Parent
+	end
+	return s and (s.."/"..table.concat(p,"/"))
+end
+
+local function serializeValue(val)
+	local t = typeof(val)
+	if t == "Vector3" then return {val.X, val.Y, val.Z}
+	elseif t == "Vector2" then return {val.X, val.Y}
+	elseif t == "Color3" then return {val.R, val.G, val.B}
+	elseif t == "CFrame" then return {val:GetComponents()}
+	elseif t == "UDim2" then return {val.X.Scale, val.X.Offset, val.Y.Scale, val.Y.Offset}
+	elseif t == "UDim" then return {val.Scale, val.Offset}
+	elseif t == "Rect" then return {val.Min.X, val.Min.Y, val.Max.X, val.Max.Y}
+	elseif t == "NumberRange" then return {val.Min, val.Max}
+	elseif t == "EnumItem" then return val.Name
+	elseif t == "Instance" then return val.Name -- Reference by name (weak)
+	elseif t == "ColorSequence" then
+		local kps = {}
+		for _, kp in ipairs(val.Keypoints) do table.insert(kps, {kp.Time, {kp.Value.R, kp.Value.G, kp.Value.B}}) end
+		return {type="ColorSequence", keypoints=kps}
+	elseif t == "NumberSequence" then
+		local kps = {}
+		for _, kp in ipairs(val.Keypoints) do table.insert(kps, {kp.Time, kp.Value, kp.Envelope}) end
+		return {type="NumberSequence", keypoints=kps}
+	else return val end
+end
+
+local PROPERTY_MAP = {
+	Instance = {"Name", "Archivable", "ClassName"},
+	BasePart = {"Size", "Position", "Color", "Transparency", "Anchored", "CanCollide", "Material", "Reflectance", "CastShadow", "Locked", "Shape"},
+	GuiObject = {"Size", "Position", "AnchorPoint", "BackgroundColor3", "BackgroundTransparency", "BorderColor3", "BorderSizePixel", "Visible", "ZIndex", "LayoutOrder", "ClipsDescendants", "Rotation"},
+	TextLabel = {"Text", "TextColor3", "TextSize", "Font", "TextTransparency", "TextXAlignment", "TextYAlignment", "TextScaled", "TextWrapped", "RichText"},
+	TextButton = {"Text", "TextColor3", "TextSize", "Font", "TextTransparency", "TextXAlignment", "TextYAlignment", "TextScaled", "TextWrapped", "RichText"},
+	TextBox = {"Text", "TextColor3", "TextSize", "Font", "TextTransparency", "TextXAlignment", "TextYAlignment", "TextScaled", "TextWrapped", "PlaceholderText", "ClearTextOnFocus", "MultiLine"},
+	ImageLabel = {"Image", "ImageColor3", "ImageTransparency", "ScaleType", "SliceCenter", "TileSize"},
+	ImageButton = {"Image", "ImageColor3", "ImageTransparency", "ScaleType", "SliceCenter", "TileSize"},
+	ValueBase = {"Value"},
+	Sound = {"SoundId", "Volume", "PlaybackSpeed", "Looped", "Playing", "TimePosition"},
+	Animation = {"AnimationId"},
+	Decal = {"Texture", "Color3", "Transparency", "Face"},
+	Texture = {"Texture", "Color3", "Transparency", "Face", "StudsPerTileU", "StudsPerTileV", "OffsetStudsU", "OffsetStudsV"},
+	Light = {"Color", "Brightness", "Enabled", "Shadows", "Range"},
+	SpotLight = {"Angle", "Face"},
+	SurfaceLight = {"Angle", "Face"},
+	DataModelMesh = {"Scale", "Offset", "VertexColor"},
+	SpecialMesh = {"MeshId", "TextureId", "MeshType"},
+	Humanoid = {"Health", "MaxHealth", "WalkSpeed", "JumpPower", "DisplayName", "RigType", "HipHeight"},
+	Tool = {"RequiresHandle", "CanBeDropped", "ToolTip", "Enabled", "Grip"},
+	Accessory = {"AttachmentPoint"},
+	Clothing = {"Color3"},
+	Shirt = {"ShirtTemplate"},
+	Pants = {"PantsTemplate"},
+	ParticleEmitter = {"Color", "LightEmission", "LightInfluence", "Size", "Texture", "Transparency", "ZOffset", "EmissionDirection", "Enabled", "Lifetime", "Rate", "Rotation", "RotSpeed", "Speed", "SpreadAngle"},
+	Trail = {"Color", "Enabled", "FaceCamera", "Lifetime", "LightEmission", "LightInfluence", "MaxLength", "MinLength", "Texture", "TextureLength", "Transparency", "WidthScale"},
+	Beam = {"Color", "Enabled", "FaceCamera", "LightEmission", "LightInfluence", "Texture", "TextureLength", "TextureMode", "Transparency", "Width0", "Width1", "ZOffset"},
+	Fire = {"Color", "Enabled", "Heat", "Size", "SecondaryColor"},
+	Smoke = {"Color", "Enabled", "Opacity", "RiseVelocity", "Size"},
+	Sparkles = {"SparkleColor", "Enabled"},
+	PostEffect = {"Enabled"},
+	BlurEffect = {"Size"},
+	BloomEffect = {"Intensity", "Size", "Threshold"},
+	ColorCorrectionEffect = {"Brightness", "Contrast", "Saturation", "TintColor"},
+	SunRaysEffect = {"Intensity", "Spread"},
+	Atmosphere = {"Density", "Offset", "Haze", "Color", "Decay", "Glare"},
+	Sky = {"SkyboxBk", "SkyboxDn", "SkyboxFt", "SkyboxLf", "SkyboxRt", "SkyboxUp", "SunTextureId", "MoonTextureId", "StarCount"},
+	UICorner = {"CornerRadius"},
+	UIStroke = {"Color", "Thickness", "Transparency", "ApplyStrokeMode", "LineJoinMode"},
+	UIGradient = {"Color", "Offset", "Rotation", "Transparency"},
+	UIPadding = {"PaddingBottom", "PaddingLeft", "PaddingRight", "PaddingTop"},
+	UIScale = {"Scale"},
+	UIListLayout = {"Padding", "FillDirection", "HorizontalAlignment", "VerticalAlignment", "SortOrder", "ItemLineAlignment"},
+	UIGridLayout = {"CellPadding", "CellSize", "FillDirection", "HorizontalAlignment", "VerticalAlignment", "SortOrder", "StartCorner"},
+	UITableLayout = {"Padding", "FillDirection", "HorizontalAlignment", "VerticalAlignment", "SortOrder"},
+	UIPageLayout = {"Padding", "FillDirection", "HorizontalAlignment", "VerticalAlignment", "SortOrder", "Animated", "Circular", "EasingDirection", "EasingStyle", "GamepadInputEnabled", "ScrollWheelInputEnabled", "TouchInputEnabled", "TweenTime"},
+}
+
+local function getProperties(inst)
+	local props = {
+		className = inst.ClassName,
+		name = inst.Name,
+		properties = {},
+		attributes = {},
+		tags = game:GetService("CollectionService"):GetTags(inst)
+	}
+	
+	-- Serialize Attributes
+	for k, v in pairs(inst:GetAttributes()) do
+		props.attributes[k] = serializeValue(v)
+	end
+	
+	-- Table-driven property serialization
+	for className, propList in pairs(PROPERTY_MAP) do
+		if inst:IsA(className) then
+			for _, propName in ipairs(propList) do
+				pcall(function()
+					props.properties[propName] = serializeValue(inst[propName])
+				end)
+			end
+		end
+	end
+
+	return props
+end
+
+local function getExtension(inst)
+	if inst:IsA("Script") then return ".server.luau"
+	elseif inst:IsA("LocalScript") then return ".client.luau"
+	elseif inst:IsA("ModuleScript") then return ".luau"
+	else return "/init.meta.json" end
+end
+
+local function getContent(inst)
+	if inst:IsA("Script") or inst:IsA("LocalScript") or inst:IsA("ModuleScript") then
+		return inst.Source
+	else
+		return HttpService:JSONEncode(getProperties(inst))
+	end
+end
+
+local function getInfo(inst)
+	return getExtension(inst), getContent(inst)
+end
+
+local function syncInstance(inst)
+	local path = getPath(inst)
+	if not path then return end
+	
+	local ext = getExtension(inst)
+	local content = getContent(inst)
+	local fullPath = path..ext
+	
+	-- Register for tracking
+	registerObject(inst, fullPath)
+	
+	pcall(function()
+		HttpService:PostAsync(SERVER_URL_BATCH, HttpService:JSONEncode({
+			files = {{filePath = fullPath, content = content}}
+		}))
+	end)
+end
+
+function registerObject(inst, fullPath)
+	if state.pathCache[inst] == fullPath then return end
+	state.pathCache[inst] = fullPath
+	
+	-- Clear old connections
+	if state.connections[inst] then
+		for _, c in pairs(state.connections[inst]) do c:Disconnect() end
+	end
+	state.connections[inst] = {}
+	
+	-- 1. Name Changed (Rename)
+	local nameCon = inst:GetPropertyChangedSignal("Name"):Connect(function()
+		if not state.isAutoSync then return end
+		local oldPath = state.pathCache[inst]
+		local newBasePath = getPath(inst)
+		if not newBasePath then return end -- Moved to invalid location
+		
+		local newPath = newBasePath .. getExtension(inst)
+		
+		if oldPath and newPath and oldPath ~= newPath then
+			-- Delete old
+			pcall(function()
+				HttpService:PostAsync(SERVER_URL_DELETE, HttpService:JSONEncode({files={oldPath}}))
+			end)
+			-- Sync new
+			syncInstance(inst)
+		end
+	end)
+	local cons = state.connections[inst]
+	cons[#cons+1] = nameCon
+	
+	-- 2. Ancestry Changed (Move or Delete)
+	local ancestryCon = inst.AncestryChanged:Connect(function(_, parent)
+		if not state.isAutoSync then return end
+		
+		if parent == nil then
+			-- Deleted
+			local oldPath = state.pathCache[inst]
+			if oldPath then
+				pcall(function()
+					HttpService:PostAsync(SERVER_URL_DELETE, HttpService:JSONEncode({files={oldPath}}))
+				end)
+				state.pathCache[inst] = nil
+				if state.connections[inst] then
+					for _, c in pairs(state.connections[inst]) do c:Disconnect() end
+					state.connections[inst] = nil
+				end
+			end
+		else
+			-- Moved
+			local oldPath = state.pathCache[inst]
+			local newBasePath = getPath(inst)
+			if not newBasePath then return end
+			
+			local newPath = newBasePath .. getExtension(inst)
+			
+			if oldPath and newPath and oldPath ~= newPath then
+				pcall(function()
+					HttpService:PostAsync(SERVER_URL_DELETE, HttpService:JSONEncode({files={oldPath}}))
+				end)
+				syncInstance(inst)
+			end
+		end
+	end)
+	cons[#cons+1] = ancestryCon
+end
+
+local function syncAll()
+	if not state.isConnected then showToast("Not connected!", "error") return end
+	showToast("Starting Batch Sync...", "info")
+	
+	local batch = {}
+	local services = {
+		game:GetService("Workspace"),
+		game:GetService("ServerScriptService"),
+		game:GetService("ReplicatedStorage"),
+		game:GetService("StarterPlayer").StarterPlayerScripts,
+		game:GetService("StarterGui"),
+		game:GetService("StarterPack"),
+		game:GetService("Lighting"),
+		game:GetService("ReplicatedFirst"),
+		game:GetService("SoundService")
+	}
+
+	local count = 0
+	for _, s in ipairs(services) do
+		-- Sync the service itself (folder)
+		local servicePath = getPath(s)
+		if servicePath then
+			-- We don't need content for the root folders usually, but we can ensure they exist
+			-- For now, let's just focus on descendants
+		end
+
+		for _, d in ipairs(s:GetDescendants()) do
+			-- Skip Terrain and Camera to reduce noise/issues
+			if d:IsA("Terrain") or d:IsA("Camera") then continue end
+			-- Skip self to prevent recursion
+			if d == script or d == plugin then continue end
+			
+			local path = getPath(d)
+			if path then
+				local ext, content = getInfo(d)
+				if ext and content then
+					local fullPath = path..ext
+					table.insert(batch, {filePath = fullPath, content = content})
+					registerObject(d, fullPath) -- Start tracking
+					count = count + 1
+					print("Roport: Queued " .. d.Name .. " -> " .. fullPath)
+				end
+			else
+				-- Debug why path is nil
+				print("Roport: Skipped " .. d.Name .. " (No Path) Parent: " .. (d.Parent and d.Parent.Name or "nil"))
+			end
+		end
+	end
+	
+	print("Roport: Found " .. count .. " items to sync.")
+	if count > 0 then
+		print("Roport: First item path: " .. batch[1].filePath)
+	end
+	
+	-- Send
+	task.spawn(function()
+		local chunkSize = 50
+		for i = 1, #batch, chunkSize do
+			local chunk = {}
+			for j = i, math.min(i + chunkSize - 1, #batch) do table.insert(chunk, batch[j]) end
+			local success, err = pcall(function() 
+				HttpService:PostAsync(SERVER_URL_BATCH, HttpService:JSONEncode({files=chunk})) 
+			end)
+			if not success then
+				warn("Roport: Batch sync failed: " .. tostring(err))
+			end
+			task.wait(0.1)
+		end
+		showToast("Sync Complete!", "success")
+	end)
+end
+
+-- Buttons
+local syncBtn = createButton("Sync All (Push)", "", syncAll)
+
+local function pullChanges()
+	if not state.isConnected then showToast("Connect first!", "error") return end
+	showToast("Checking for updates...", "info")
+	
+	local success, res = pcall(function() 
+		return HttpService:GetAsync(SERVER_URL_POLL .. "?t=" .. os.time()) 
+	end)
+	
+	if success then
+		local data = HttpService:JSONDecode(res)
+		if data.changes and #data.changes > 0 then
+			print("Roport: Pulling " .. #data.changes .. " files...")
+			for _, change in ipairs(data.changes) do
+				applyUpdate(change.filePath, change.content)
+			end
+			showToast("Updated " .. #data.changes .. " files", "success")
+		else
+			showToast("No changes found", "info")
+		end
+	else
+		warn("Roport: Pull failed: " .. tostring(res))
+		showToast("Pull Failed", "error")
+	end
+end
+
+local pullBtn = createButton("Pull Changes", "", pullChanges)
+
+local autoPullBtn = createButton("Auto-Pull: OFF", "", function()
+	if not state.isConnected then showToast("Connect first!", "error") return end
+	state.isAutoPull = not state.isAutoPull
+	
+	local lbl = autoPullBtn:FindFirstChild("TextLabel")
+	
+	if state.isAutoPull then
+		showToast("Auto-Pull Enabled", "success")
+		if lbl then lbl.Text = "Auto-Pull: ON" end
+		autoPullBtn.BackgroundColor3 = COLORS.ACCENT
+	else
+		showToast("Auto-Pull Disabled", "info")
+		if lbl then lbl.Text = "Auto-Pull: OFF" end
+		autoPullBtn.BackgroundColor3 = COLORS.BUTTON
+	end
+end)
+
+local autoBtn -- Forward declaration
+
+autoBtn = createButton("Auto-Sync: OFF", "", function()
+	if not state.isConnected then showToast("Connect first!", "error") return end
+	state.isAutoSync = not state.isAutoSync
+	
+	local lbl = autoBtn:FindFirstChild("TextLabel")
+	
+	if state.isAutoSync then
+		showToast("Auto-Sync Enabled", "success")
+		if lbl then lbl.Text = "Auto-Sync: ON" end
+		autoBtn.BackgroundColor3 = COLORS.ACCENT
+	else
+		showToast("Auto-Sync Disabled", "info")
+		if lbl then lbl.Text = "Auto-Sync: OFF" end
+		autoBtn.BackgroundColor3 = COLORS.BUTTON
+	end
+end)
+
+-- Auto Sync Logic
+local dirtyScripts = {}
+local lastSyncTime = 0
+local SYNC_INTERVAL = 2 -- Seconds
+
+ScriptEditorService.TextDocumentDidChange:Connect(function(document, changes)
+	if not state.isAutoSync or not state.isConnected then return end
+	
+	local script = document:GetScript()
+	if script then
+		dirtyScripts[script] = true
+	end
+end)
+
+task.spawn(function()
+	while true do
+		task.wait(0.5)
+		if state.isAutoSync and state.isConnected then
+			if os.time() - lastSyncTime >= SYNC_INTERVAL then
+				local batch = {}
+				local count = 0
+				
+				for script, _ in pairs(dirtyScripts) do
+					if script.Parent then -- Ensure script still exists
+						local path = getPath(script)
+						if path then
+							local ext, content = getInfo(script)
+							if ext and content then
+								local fullPath = path..ext
+								table.insert(batch, {filePath = fullPath, content = content})
+								count = count + 1
+								registerObject(script, fullPath) -- Ensure tracking
+							end
+						end
+					end
+				end
+				
+				if count > 0 then
+					-- Clear dirty list immediately to avoid double sync
+					dirtyScripts = {}
+					
+					local success, err = pcall(function()
+						HttpService:PostAsync(SERVER_URL_BATCH, HttpService:JSONEncode({files=batch}))
+					end)
+					
+					if success then
+						lastSyncTime = os.time()
+						print("Roport: Auto-synced " .. count .. " scripts")
+					else
+						warn("Roport: Auto-sync failed: " .. tostring(err))
+					end
+				end
+			end
+		end
+	end
+end)
+
+-- Connection Logic
+local hasPrompted = false
+
+local function checkConnection()
+	local success, _ = pcall(function() return HttpService:GetAsync(SERVER_URL_PING) end)
+	
+	if success then
+		if not state.isConnected then
+			-- Server just appeared
+			if not hasPrompted then
+				print("Roport: Server detected, prompting user...")
+				hasPrompted = true
+				showModal("Server Detected", "VS Code sync server is running. Connect now?", function()
+					state.isConnected = true
+					statusDot.BackgroundColor3 = COLORS.SUCCESS
+					statusText.Text = "Connected"
+					showToast("Connected to VS Code", "success")
+					
+					-- Ask for initial sync
+					task.wait(0.5)
+					showModal("Initial Sync", "Do you want to sync the workspace to VS Code now?", function()
+						syncAll()
+					end)
+				end)
+			end
+		end
+	else
+		state.isConnected = false
+		statusDot.BackgroundColor3 = COLORS.ERROR
+		statusText.Text = "Disconnected (Server Offline)"
+		hasPrompted = false -- Reset so we prompt again if it comes back
+	end
+end
+
+-- Two-Way Sync Logic
+local function findInstanceByPath(path)
+	-- Remove extension
+	local cleanPath = path:gsub("%.server%.luau$", ""):gsub("%.client%.luau$", ""):gsub("%.luau$", ""):gsub("/init%.meta%.json$", "")
+	
+	local parts = cleanPath:split("/")
+	if parts[1] ~= "src" then return nil end
+	
+	local current = nil
+	
+	-- Map src/xxx to Service
+	local serviceMap = {
+		workspace = game:GetService("Workspace"),
+		server = game:GetService("ServerScriptService"),
+		shared = game:GetService("ReplicatedStorage"),
+		client = game:GetService("StarterPlayer").StarterPlayerScripts,
+		interface = game:GetService("StarterGui"),
+		tools = game:GetService("StarterPack"),
+		lighting = game:GetService("Lighting"),
+		first = game:GetService("ReplicatedFirst"),
+		sounds = game:GetService("SoundService")
+	}
+	
+	current = serviceMap[parts[2]]
+	if not current then return nil end
+	
+	for i = 3, #parts do
+		local name = parts[i]
+		current = current:FindFirstChild(name)
+		if not current then return nil end
+	end
+	
+	return current
+end
+
+local function createInstanceByPath(path, content)
+	local cleanPath = path:gsub("%.server%.luau$", ""):gsub("%.client%.luau$", ""):gsub("%.luau$", ""):gsub("/init%.meta%.json$", "")
+	local parts = cleanPath:split("/")
+	if parts[1] ~= "src" then return nil end
+	
+	local serviceMap = {
+		workspace = game:GetService("Workspace"),
+		server = game:GetService("ServerScriptService"),
+		shared = game:GetService("ReplicatedStorage"),
+		client = game:GetService("StarterPlayer").StarterPlayerScripts,
+		interface = game:GetService("StarterGui"),
+		tools = game:GetService("StarterPack"),
+		lighting = game:GetService("Lighting"),
+		first = game:GetService("ReplicatedFirst"),
+		sounds = game:GetService("SoundService")
+	}
+	
+	local current = serviceMap[parts[2]]
+	if not current then return nil end
+	
+	for i = 3, #parts do
+		local name = parts[i]
+		local nextInst = current:FindFirstChild(name)
+		
+		if not nextInst then
+			local isLast = (i == #parts)
+			local className = "Folder"
+			
+			if isLast then
+				if path:match("%.server%.luau$") then className = "Script"
+				elseif path:match("%.client%.luau$") then className = "LocalScript"
+				elseif path:match("%.luau$") then className = "ModuleScript"
+				elseif path:match("%.json$") then
+					-- Try to peek className from content
+					local success, data = pcall(function() return HttpService:JSONDecode(content) end)
+					if success and data.className then
+						className = data.className
+					end
+				end
+			end
+			
+			local success, newInst = pcall(function() return Instance.new(className) end)
+			if success and newInst then
+				newInst.Name = name
+				newInst.Parent = current
+				nextInst = newInst
+			else
+				warn("Roport: Failed to create " .. className .. " for " .. name)
+				return nil
+			end
+		end
+		current = nextInst
+	end
+	return current
+end
+
+local function applyUpdate(filePath, content)
+	local inst = findInstanceByPath(filePath)
+	if not inst then 
+		inst = createInstanceByPath(filePath, content)
+		if not inst then return end
+	end
+	
+	if filePath:match("%.json$") then
+		local success, data = pcall(function() return HttpService:JSONDecode(content) end)
+		if not success then return end
+		
+		-- Update properties
+		if data.properties then
+			for prop, val in pairs(data.properties) do
+				pcall(function()
+					local currentVal = inst[prop]
+					local targetType = typeof(currentVal)
+					
+					if type(val) == "table" and targetType ~= "table" then
+						-- Deserialize complex types
+						if targetType == "Color3" then 
+							inst[prop] = Color3.new(val[1], val[2], val[3])
+						elseif targetType == "Vector3" then 
+							inst[prop] = Vector3.new(val[1], val[2], val[3])
+						elseif targetType == "UDim2" then 
+							inst[prop] = UDim2.new(val[1], val[2], val[3], val[4])
+						elseif targetType == "UDim" then 
+							inst[prop] = UDim.new(val[1], val[2])
+						elseif targetType == "Rect" then 
+							inst[prop] = Rect.new(val[1], val[2], val[3], val[4])
+						elseif targetType == "NumberRange" then 
+							inst[prop] = NumberRange.new(val[1], val[2])
+						end
+					else
+						inst[prop] = val
+					end
+				end)
+			end
+		end
+	elseif filePath:match("%.luau$") or filePath:match("%.lua$") then
+		if inst:IsA("LuaSourceContainer") then
+			inst.Source = content
+		end
+	end
+	print("Roport: Updated " .. inst.Name .. " from VS Code")
+end
+
+task.spawn(function()
+	while true do
+		task.wait(1)
+		if state.isConnected and state.isAutoPull then
+			local success, res = pcall(function() 
+				return HttpService:GetAsync(SERVER_URL_POLL .. "?t=" .. os.time()) 
+			end)
+			
+			if success then
+				local data = HttpService:JSONDecode(res)
+				if data.changes and #data.changes > 0 then
+					print("Roport: Received " .. #data.changes .. " updates from VS Code")
+					for _, change in ipairs(data.changes) do
+						applyUpdate(change.filePath, change.content)
+					end
+				end
+			else
+				warn("Roport: Poll failed: " .. tostring(res))
+			end
+		end
+	end
+end)
+
+task.spawn(function()
+	while true do
+		checkConnection()
+		task.wait(3)
+	end
+end)
+
+toggleButton.Click:Connect(function() widget.Enabled = not widget.Enabled end)

package/src/server.js

@@ -0,0 +1,166 @@
+const express = require('express');
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+function startServer(port) {
+    const app = express();
+    
+    // Determine project root
+    let projectRoot = process.cwd();
+    if (fs.existsSync(path.join(projectRoot, 'src'))) {
+        // We are in the root
+    } else if (fs.existsSync(path.join(projectRoot, '../src'))) {
+        // We are in cli/ or similar
+        projectRoot = path.resolve(projectRoot, '..');
+    }
+    console.log(chalk.cyan(`Project Root: ${projectRoot}`));
+
+    // State for two-way sync
+    let changedFiles = new Set();
+    let isWriting = false; // Lock to prevent loops (Roblox -> File -> Watcher -> Roblox)
+
+    // Watch for file changes locally
+    try {
+        console.log(chalk.gray(`Starting file watcher on ${projectRoot}...`));
+        fs.watch(projectRoot, { recursive: true }, (eventType, filename) => {
+            // Debug log
+            // console.log('Raw event:', eventType, filename);
+
+            if (filename && !isWriting) {
+                // Ignore system folders and the cli folder itself if we are watching root
+                if (filename.includes('node_modules') || filename.includes('.git') || filename.startsWith('cli')) return;
+                
+                // Normalize path to forward slashes
+                const relativePath = filename.replace(/\\/g, '/');
+                
+                // Debounce/Deduplicate slightly
+                if (!changedFiles.has(relativePath)) {
+                    changedFiles.add(relativePath);
+                    console.log(chalk.yellow(`File changed: ${relativePath} (${eventType})`));
+                }
+            }
+        });
+    } catch (e) {
+        console.warn(chalk.red("File watching failed (might not be supported on this OS):"), e);
+    }
+
+    // Increase limit for large file batches
+    app.use(express.json({ limit: '50mb' }));
+
+    app.get('/ping', (req, res) => {
+        res.send('pong');
+    });
+
+    // New endpoint for Roblox to poll for changes
+    app.get('/poll', async (req, res) => {
+        if (changedFiles.size === 0) {
+            return res.send({ changes: [] });
+        }
+
+        const changes = [];
+        const filesToProcess = Array.from(changedFiles);
+        changedFiles.clear(); // Clear immediately so we don't send duplicates
+
+        for (const filePath of filesToProcess) {
+            try {
+                const fullPath = path.resolve(projectRoot, filePath);
+                // Only send if file still exists (it might have been deleted)
+                if (await fs.pathExists(fullPath)) {
+                    const stat = await fs.stat(fullPath);
+                    if (stat.isFile()) {
+                        const content = await fs.readFile(fullPath, 'utf8');
+                        changes.push({ filePath, content });
+                    }
+                }
+            } catch (e) {
+                console.error(chalk.red(`Error reading changed file ${filePath}:`), e);
+            }
+        }
+
+        if (changes.length > 0) {
+            console.log(chalk.magenta(`Sending ${changes.length} updates to Roblox`));
+        }
+        res.send({ changes });
+    });
+
+    app.post('/batch', async (req, res) => {
+        const { files } = req.body;
+        
+        if (!files || !Array.isArray(files)) {
+            return res.status(400).send('Invalid body');
+        }
+
+        console.log(chalk.blue(`Received batch of ${files.length} files`));
+        
+        isWriting = true; // Lock watcher
+
+        try {
+            for (const file of files) {
+                const { filePath, content } = file;
+                // Prevent directory traversal
+                const safePath = path.resolve(projectRoot, filePath);
+                if (!safePath.startsWith(projectRoot)) {
+                    console.warn(chalk.yellow(`Skipping unsafe path: ${filePath}`));
+                    continue;
+                }
+
+                if (filePath.endsWith('.json')) {
+                    try {
+                        const json = JSON.parse(content);
+                        await fs.outputFile(safePath, JSON.stringify(json, null, 2));
+                    } catch (e) {
+                        await fs.outputFile(safePath, content);
+                    }
+                } else {
+                    await fs.outputFile(safePath, content);
+                }
+                console.log(chalk.green(`Synced: ${filePath}`));
+            }
+            res.send({ success: true });
+        } catch (err) {
+            console.error(chalk.red('Error syncing files:'), err);
+            res.status(500).send({ error: err.message });
+        } finally {
+            // Release lock after a short delay to let FS settle
+            setTimeout(() => { isWriting = false; }, 500);
+        }
+    });
+
+    app.post('/delete', async (req, res) => {
+        const { files } = req.body;
+        
+        if (!files || !Array.isArray(files)) {
+            return res.status(400).send('Invalid body');
+        }
+
+        console.log(chalk.blue(`Received delete request for ${files.length} files`));
+
+        try {
+            for (const filePath of files) {
+                // Prevent directory traversal
+                const safePath = path.resolve(projectRoot, filePath);
+                if (!safePath.startsWith(projectRoot)) {
+                    console.warn(chalk.yellow(`Skipping unsafe delete path: ${filePath}`));
+                    continue;
+                }
+
+                if (await fs.pathExists(safePath)) {
+                    await fs.remove(safePath);
+                    console.log(chalk.magenta(`Deleted: ${filePath}`));
+                }
+            }
+            res.send({ success: true });
+        } catch (err) {
+            console.error(chalk.red('Error deleting files:'), err);
+            res.status(500).send({ error: err.message });
+        }
+    });
+
+    app.listen(port, () => {
+        console.log(chalk.cyan(`Roport server running on http://127.0.0.1:${port}`));
+        console.log(chalk.gray('Waiting for requests...'));
+    });
+}
+
+module.exports = { startServer };