@joycostudio/studio 0.0.2 → 0.1.0

package/dist/react.js

@@ -7,13 +7,14 @@ import {
   LoaderCircle,
   PanelLeftClose,
   PanelLeftOpen,
+  Pin as Pin2,
   PlugZap,
   Unplug
 } from "lucide-react";
-import { useEffect as useEffect3, useRef as useRef2, useState as useState4 } from "react";
+import { useEffect as useEffect4, useRef as useRef3, useState as useState7 } from "react";
 
 // package.json
-var version = "0.0.2";
+var version = "0.1.0";
 
 // src/client/studio.ts
 import { button } from "@joycostudio/xyz/debug";
@@ -241,9 +242,72 @@ function TooltipContent({
     }
   ) });
 }
+function Hint({
+  children,
+  content,
+  ...props
+}) {
+  return /* @__PURE__ */ jsxs(Tooltip, { children: [
+    /* @__PURE__ */ jsx4(TooltipTrigger, { asChild: true, children }),
+    /* @__PURE__ */ jsx4(TooltipContent, { ...props, children: content })
+  ] });
+}
+
+// src/react/ui/panel.tsx
+import { Slot as Slot3 } from "radix-ui";
+import { forwardRef as forwardRef2 } from "react";
+
+// src/react/surface.tsx
+import { Slot as Slot2 } from "radix-ui";
+import { forwardRef } from "react";
+import { jsx as jsx5 } from "react/jsx-runtime";
+var StudioSurface = forwardRef(
+  function StudioSurface2({ asChild = false, className, ...props }, ref) {
+    const Comp = asChild ? Slot2.Root : "div";
+    return /* @__PURE__ */ jsx5(Comp, { ref, "data-slot": "studio-surface", className: cn("studio-surface", className), ...props });
+  }
+);
+var StudioToolbar = forwardRef(function StudioToolbar2({ className, ...props }, ref) {
+  return /* @__PURE__ */ jsx5(StudioSurface, { ref, role: "group", className: cn("studio-toolbar", className), ...props });
+});
+
+// src/react/ui/panel.tsx
+import { jsx as jsx6 } from "react/jsx-runtime";
+var Panel = forwardRef2(function Panel2({ className, asChild = false, ...props }, ref) {
+  const Comp = asChild ? Slot3.Root : "div";
+  return /* @__PURE__ */ jsx6(
+    Comp,
+    {
+      ref,
+      "data-slot": "panel",
+      className: cn(
+        "rounded-lg border border-sidebar-border bg-sidebar/85 shadow-xl shadow-black/40 backdrop-blur-xl",
+        className
+      ),
+      ...props
+    }
+  );
+});
+function PanelHeader({ className, ...props }) {
+  return /* @__PURE__ */ jsx6(StudioSurface, { asChild: true, className: cn("px-3 pt-2.5 pb-2", className), children: /* @__PURE__ */ jsx6("header", { "data-slot": "panel-header", ...props }) });
+}
+var PanelContent = forwardRef2(function PanelContent2({ className, ...props }, ref) {
+  return /* @__PURE__ */ jsx6(
+    "div",
+    {
+      ref,
+      "data-slot": "panel-content",
+      className: cn("min-h-0 flex-1 overflow-auto px-1 py-1.5", className),
+      ...props
+    }
+  );
+});
+function PanelFooter({ className, ...props }) {
+  return /* @__PURE__ */ jsx6(StudioSurface, { asChild: true, className: cn("grid gap-2 p-2", className), children: /* @__PURE__ */ jsx6("footer", { "data-slot": "panel-footer", ...props }) });
+}
 
 // src/react/inspector.tsx
-import { jsx as jsx5, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx7, jsxs as jsxs2 } from "react/jsx-runtime";
 function describe(studio, handle) {
   const { state } = handle;
   if (studio.connection.phase !== "connected") return { tone: "text-faint", text: "Not persisting" };
@@ -256,7 +320,8 @@ function describe(studio, handle) {
 function Inspector({
   studio,
   handle,
-  onCompare
+  onCompare,
+  fileHref
 }) {
   useStudio(studio);
   const container = useRef(null);
@@ -299,74 +364,80 @@ function Inspector({
     if (pane.current) pane.current.disabled = handle.comparing;
   });
   const { definition, state } = handle;
+  const ConfigFile = fileHref ? "a" : "span";
   const status = describe(studio, handle);
   const editable2 = studio.connection.phase === "connected" && !!state?.dirty && !handle.comparing;
   const changes = (state?.dirty ? changedPaths(state.saved.value, state.draft.value) : []).map(
     (path) => path.split(".").map((key) => key.charAt(0).toUpperCase() + key.slice(1)).join(" \u203A ")
   );
-  return /* @__PURE__ */ jsxs2("div", { className: "flex min-h-0 flex-1 flex-col gap-1 p-1", children: [
-    /* @__PURE__ */ jsxs2("header", { className: "rounded-[calc(var(--radius-lg)-0.25rem)] bg-card px-3 pt-2.5 pb-2", children: [
+  return /* @__PURE__ */ jsxs2(Fragment, { children: [
+    /* @__PURE__ */ jsxs2(PanelHeader, { children: [
       /* @__PURE__ */ jsxs2("strong", { className: "flex min-w-0 items-center gap-2 text-foreground", children: [
-        /* @__PURE__ */ jsx5(ToolIcon, { icon: definition.icon, className: "size-3.5 shrink-0" }),
-        /* @__PURE__ */ jsx5("span", { className: "truncate", title: definition.title ?? definition.id, children: definition.title ?? definition.id })
+        /* @__PURE__ */ jsx7(ToolIcon, { icon: definition.icon, className: "size-3.5 shrink-0" }),
+        /* @__PURE__ */ jsx7("span", { className: "truncate", title: definition.title ?? definition.id, children: definition.title ?? definition.id })
       ] }),
       /* @__PURE__ */ jsxs2("div", { className: "mt-1 flex items-center gap-3 pl-5.5 text-[11px]", children: [
-        /* @__PURE__ */ jsx5("span", { className: "min-w-0 flex-1 truncate text-muted-foreground", title: definition.file, children: definition.file }),
+        /* @__PURE__ */ jsx7(
+          ConfigFile,
+          {
+            "data-slot": "studio-config-file",
+            className: "min-w-0 flex-1 truncate text-muted-foreground",
+            href: fileHref,
+            title: fileHref ? `Open ${definition.file}` : definition.file,
+            children: definition.file
+          }
+        ),
         /* @__PURE__ */ jsxs2(
           "span",
           {
             className: `flex shrink-0 items-center gap-1.5 ${status.tone}`,
             title: state ? `Draft revision ${state.draft.revision}` : void 0,
             children: [
-              /* @__PURE__ */ jsx5("span", { "aria-hidden": "true", className: "size-1.5 rounded-full bg-current" }),
+              /* @__PURE__ */ jsx7("span", { "aria-hidden": "true", className: "size-1.5 rounded-full bg-current" }),
               status.text
             ]
           }
         )
       ] })
     ] }),
-    /* @__PURE__ */ jsx5(
-      "div",
-      {
-        ref: container,
-        "data-slot": "studio-controls",
-        className: "min-h-0 flex-1 overflow-auto px-1 py-1.5",
-        style: tweakpaneTheme
-      }
-    ),
-    /* @__PURE__ */ jsxs2("footer", { className: "grid gap-2 rounded-[calc(var(--radius-lg)-0.25rem)] bg-card p-2", children: [
-      failure && /* @__PURE__ */ jsx5("div", { className: "text-destructive", children: failure }),
+    /* @__PURE__ */ jsx7(PanelContent, { ref: container, "data-slot": "studio-controls", style: tweakpaneTheme }),
+    /* @__PURE__ */ jsxs2(PanelFooter, { children: [
+      failure && /* @__PURE__ */ jsx7("div", { className: "text-destructive", children: failure }),
       changes.length > 0 && /* @__PURE__ */ jsxs2("div", { className: "truncate text-muted-foreground", title: changes.join(", "), children: [
         changes.length,
         " changed: ",
-        /* @__PURE__ */ jsx5("span", { className: "text-foreground", children: changes.join(", ") })
+        /* @__PURE__ */ jsx7("span", { className: "text-foreground", children: changes.join(", ") })
       ] }),
       /* @__PURE__ */ jsxs2("div", { className: "flex gap-2", children: [
-        /* @__PURE__ */ jsxs2(Tooltip, { children: [
-          /* @__PURE__ */ jsx5(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsx5(
-            Button,
-            {
-              variant: "secondary",
-              size: "icon-sm",
-              "aria-label": "Hold to compare with saved",
-              "aria-pressed": handle.comparing,
-              disabled: !state?.dirty,
-              className: "shrink-0 aria-pressed:bg-primary aria-pressed:text-primary-foreground",
-              onPointerDown: (event) => {
-                event.currentTarget.setPointerCapture(event.pointerId);
-                onCompare(true);
-              },
-              onPointerUp: () => onCompare(false),
-              onPointerCancel: () => onCompare(false),
-              children: /* @__PURE__ */ jsx5(SquareSplitHorizontal, {})
-            }
-          ) }),
-          /* @__PURE__ */ jsxs2(TooltipContent, { className: "flex items-center gap-2", children: [
-            "Hold to compare with saved ",
-            /* @__PURE__ */ jsx5(Kbd, { children: "\\" })
-          ] })
-        ] }),
-        /* @__PURE__ */ jsx5(
+        /* @__PURE__ */ jsx7(
+          Hint,
+          {
+            className: "flex items-center gap-2",
+            content: /* @__PURE__ */ jsxs2(Fragment, { children: [
+              "Hold to compare with saved ",
+              /* @__PURE__ */ jsx7(Kbd, { children: "\\" })
+            ] }),
+            children: /* @__PURE__ */ jsx7(
+              Button,
+              {
+                variant: "secondary",
+                size: "icon-sm",
+                "aria-label": "Hold to compare with saved",
+                "aria-pressed": handle.comparing,
+                disabled: !state?.dirty,
+                className: "shrink-0 aria-pressed:bg-primary aria-pressed:text-primary-foreground",
+                onPointerDown: (event) => {
+                  event.currentTarget.setPointerCapture(event.pointerId);
+                  onCompare(true);
+                },
+                onPointerUp: () => onCompare(false),
+                onPointerCancel: () => onCompare(false),
+                children: /* @__PURE__ */ jsx7(SquareSplitHorizontal, {})
+              }
+            )
+          }
+        ),
+        /* @__PURE__ */ jsx7(
           Button,
           {
             variant: "secondary",
@@ -377,11 +448,11 @@ function Inspector({
             children: "Discard"
           }
         ),
-        state?.conflict ? /* @__PURE__ */ jsx5(Button, { variant: "destructive", size: "sm", className: "flex-1", onClick: () => save(true), children: "Overwrite file" }) : /* @__PURE__ */ jsxs2(Button, { size: "sm", className: "flex-1", disabled: !editable2, onClick: () => save(), children: [
+        state?.conflict ? /* @__PURE__ */ jsx7(Button, { variant: "destructive", size: "sm", className: "flex-1", onClick: () => save(true), children: "Overwrite file" }) : /* @__PURE__ */ jsxs2(Button, { size: "sm", className: "flex-1", disabled: !editable2, onClick: () => save(), children: [
           "Save",
           /* @__PURE__ */ jsxs2(KbdGroup, { children: [
-            /* @__PURE__ */ jsx5(Kbd, { children: "\u2318" }),
-            /* @__PURE__ */ jsx5(Kbd, { children: "S" })
+            /* @__PURE__ */ jsx7(Kbd, { children: "\u2318" }),
+            /* @__PURE__ */ jsx7(Kbd, { children: "S" })
           ] })
         ] })
       ] })
@@ -390,16 +461,148 @@ function Inspector({
 }
 
 // src/react/logo.tsx
-import { jsx as jsx6 } from "react/jsx-runtime";
+import { jsx as jsx8 } from "react/jsx-runtime";
 function Logo(props) {
-  return /* @__PURE__ */ jsx6("svg", { viewBox: "0 0 352 144", fill: "currentColor", "aria-label": "JOYCO", role: "img", ...props, children: /* @__PURE__ */ jsx6("path", { d: "M328 96L280 144H0V40H176V112H192V24H0V0H352V24H328V96Z" }) });
+  return /* @__PURE__ */ jsx8("svg", { viewBox: "0 0 352 144", fill: "currentColor", "aria-label": "JOYCO", role: "img", ...props, children: /* @__PURE__ */ jsx8("path", { d: "M328 96L280 144H0V40H176V112H192V24H0V0H352V24H328V96Z" }) });
 }
 
+// src/react/pinned-tools.ts
+import { useEffect as useEffect2, useState as useState2 } from "react";
+var STORAGE_KEY = "joyco-studio:pinned-tools";
+var CHANGE_EVENT = "joyco-studio:pins-changed";
+function readPins() {
+  try {
+    const value = JSON.parse(localStorage.getItem(STORAGE_KEY) ?? "[]");
+    return Array.isArray(value) ? value.filter((id) => typeof id === "string") : [];
+  } catch {
+    return [];
+  }
+}
+function usePinnedTools(studio) {
+  const [pins, setPins] = useState2([]);
+  useEffect2(() => {
+    setPins(readPins());
+    const onChange = (event) => setPins(event.detail);
+    const onStorage = (event) => {
+      if (event.key === STORAGE_KEY || event.key === null) setPins(readPins());
+    };
+    window.addEventListener(CHANGE_EVENT, onChange);
+    window.addEventListener("storage", onStorage);
+    return () => {
+      window.removeEventListener(CHANGE_EVENT, onChange);
+      window.removeEventListener("storage", onStorage);
+    };
+  }, []);
+  const pinned = new Set(pins);
+  const tools = [...studio.tools].sort(
+    (a, b) => Number(pinned.has(b.definition.id)) - Number(pinned.has(a.definition.id))
+  );
+  const togglePin = (id) => {
+    const next = pinned.has(id) ? pins.filter((pin) => pin !== id) : [...pins, id];
+    try {
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(next));
+    } catch {
+    }
+    window.dispatchEvent(new CustomEvent(CHANGE_EVENT, { detail: next }));
+  };
+  return { tools, pinned, togglePin };
+}
+
+// src/react/preview-canvas.tsx
+import { RotateCw } from "lucide-react";
+import { forwardRef as forwardRef3, useImperativeHandle, useRef as useRef2, useState as useState4 } from "react";
+
+// src/react/canvas-toolbar.tsx
+import { Maximize, Minimize, Pin, PinOff } from "lucide-react";
+import { useState as useState3 } from "react";
+import { jsx as jsx9, jsxs as jsxs3 } from "react/jsx-runtime";
+function CanvasToolbar({ label, expanded = false, onToggle, children }) {
+  const [ghost, setGhost] = useState3(false);
+  const ExpandIcon = expanded ? Minimize : Maximize;
+  const PinIcon = ghost ? PinOff : Pin;
+  return /* @__PURE__ */ jsx9(
+    "div",
+    {
+      className: "studio-canvas-toolbar",
+      "data-slot": "canvas-toolbar",
+      "data-expanded": expanded || void 0,
+      "data-ghost": !expanded && ghost || void 0,
+      role: "group",
+      "aria-label": label,
+      children: /* @__PURE__ */ jsxs3(StudioToolbar, { className: "studio-canvas-actions", children: [
+        children,
+        onToggle && /* @__PURE__ */ jsx9("div", { className: "studio-canvas-toggle", children: /* @__PURE__ */ jsxs3("button", { "data-slot": "toolbar-action", type: "button", "aria-pressed": expanded, onClick: onToggle, children: [
+          /* @__PURE__ */ jsx9(ExpandIcon, { size: 14, strokeWidth: 1.5, "aria-hidden": true }),
+          expanded ? "Contain canvas" : "Expand"
+        ] }) }),
+        !expanded && /* @__PURE__ */ jsx9(
+          "button",
+          {
+            type: "button",
+            "aria-label": `Auto-hide ${label.toLowerCase()} header`,
+            "aria-pressed": ghost,
+            title: ghost ? "Pin header" : "Auto-hide header",
+            onClick: () => setGhost(!ghost),
+            children: /* @__PURE__ */ jsx9(PinIcon, { size: 14, strokeWidth: 1.5, "aria-hidden": true })
+          }
+        )
+      ] })
+    }
+  );
+}
+
+// src/react/preview-canvas.tsx
+import { jsx as jsx10, jsxs as jsxs4 } from "react/jsx-runtime";
+var PreviewCanvas = forwardRef3(function PreviewCanvas2({ title = "Preview", expanded: controlled, onExpandedChange, onReload, toolbar, ...props }, ref) {
+  const [localExpanded, setExpanded] = useState4(false);
+  const expanded = controlled ?? localExpanded;
+  const frame = useRef2(null);
+  useImperativeHandle(ref, () => frame.current, []);
+  return /* @__PURE__ */ jsxs4(
+    "section",
+    {
+      className: "studio-preview-canvas",
+      "data-slot": "preview-canvas",
+      "data-expanded": expanded || void 0,
+      "aria-label": `${title} canvas`,
+      children: [
+        /* @__PURE__ */ jsxs4(
+          CanvasToolbar,
+          {
+            label: "Preview canvas",
+            expanded,
+            onToggle: () => {
+              setExpanded(!expanded);
+              onExpandedChange?.(!expanded);
+            },
+            children: [
+              /* @__PURE__ */ jsx10(
+                "button",
+                {
+                  type: "button",
+                  "aria-label": "Reload preview",
+                  title: "Reload preview",
+                  onClick: () => {
+                    onReload?.();
+                    if (frame.current) frame.current.src = frame.current.src;
+                  },
+                  children: /* @__PURE__ */ jsx10(RotateCw, { size: 14, strokeWidth: 1.5, "aria-hidden": true })
+                }
+              ),
+              /* @__PURE__ */ jsx10("div", { className: "studio-preview-source", children: toolbar ?? /* @__PURE__ */ jsx10("span", { className: "studio-preview-title", children: title }) })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsx10("iframe", { ...props, ref: frame, title })
+      ]
+    }
+  );
+});
+
 // src/react/ui/sidebar.tsx
 import * as React2 from "react";
 import { cva as cva2 } from "class-variance-authority";
-import { PanelLeftIcon } from "lucide-react";
-import { Slot as Slot2 } from "radix-ui";
+import { Slot as Slot4 } from "radix-ui";
 
 // src/react/ui/hooks/use-mobile.ts
 import * as React from "react";
@@ -421,15 +624,15 @@ function useIsMobile() {
 // src/react/ui/sheet.tsx
 import { XIcon } from "lucide-react";
 import { Dialog as SheetPrimitive } from "radix-ui";
-import { jsx as jsx7, jsxs as jsxs3 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs5 } from "react/jsx-runtime";
 function Sheet({ ...props }) {
-  return /* @__PURE__ */ jsx7(SheetPrimitive.Root, { "data-slot": "sheet", ...props });
+  return /* @__PURE__ */ jsx11(SheetPrimitive.Root, { "data-slot": "sheet", ...props });
 }
 function SheetPortal({ ...props }) {
-  return /* @__PURE__ */ jsx7(SheetPrimitive.Portal, { "data-slot": "sheet-portal", ...props });
+  return /* @__PURE__ */ jsx11(SheetPrimitive.Portal, { "data-slot": "sheet-portal", ...props });
 }
 function SheetOverlay({ className, ...props }) {
-  return /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsx11(
     SheetPrimitive.Overlay,
     {
       "data-slot": "sheet-overlay",
@@ -448,9 +651,9 @@ function SheetContent({
   showCloseButton = true,
   ...props
 }) {
-  return /* @__PURE__ */ jsxs3(SheetPortal, { children: [
-    /* @__PURE__ */ jsx7(SheetOverlay, {}),
-    /* @__PURE__ */ jsxs3(
+  return /* @__PURE__ */ jsxs5(SheetPortal, { children: [
+    /* @__PURE__ */ jsx11(SheetOverlay, {}),
+    /* @__PURE__ */ jsxs5(
       SheetPrimitive.Content,
       {
         "data-slot": "sheet-content",
@@ -465,9 +668,9 @@ function SheetContent({
         ...props,
         children: [
           children,
-          showCloseButton && /* @__PURE__ */ jsxs3(SheetPrimitive.Close, { className: "absolute top-4 right-4 rounded-xs opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none data-[state=open]:bg-secondary", children: [
-            /* @__PURE__ */ jsx7(XIcon, { className: "size-4" }),
-            /* @__PURE__ */ jsx7("span", { className: "sr-only", children: "Close" })
+          showCloseButton && /* @__PURE__ */ jsxs5(SheetPrimitive.Close, { className: "absolute top-4 right-4 rounded-xs opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:ring-2 focus:ring-ring focus:ring-offset-2 focus:outline-hidden disabled:pointer-events-none data-[state=open]:bg-secondary", children: [
+            /* @__PURE__ */ jsx11(XIcon, { className: "size-4" }),
+            /* @__PURE__ */ jsx11("span", { className: "sr-only", children: "Close" })
           ] })
         ]
       }
@@ -475,10 +678,10 @@ function SheetContent({
   ] });
 }
 function SheetHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx7("div", { "data-slot": "sheet-header", className: cn("flex flex-col gap-1.5 p-4", className), ...props });
+  return /* @__PURE__ */ jsx11("div", { "data-slot": "sheet-header", className: cn("flex flex-col gap-1.5 p-4", className), ...props });
 }
 function SheetTitle({ className, ...props }) {
-  return /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsx11(
     SheetPrimitive.Title,
     {
       "data-slot": "sheet-title",
@@ -488,7 +691,7 @@ function SheetTitle({ className, ...props }) {
   );
 }
 function SheetDescription({ className, ...props }) {
-  return /* @__PURE__ */ jsx7(
+  return /* @__PURE__ */ jsx11(
     SheetPrimitive.Description,
     {
       "data-slot": "sheet-description",
@@ -499,7 +702,7 @@ function SheetDescription({ className, ...props }) {
 }
 
 // src/react/ui/sidebar.tsx
-import { jsx as jsx8, jsxs as jsxs4 } from "react/jsx-runtime";
+import { jsx as jsx12, jsxs as jsxs6 } from "react/jsx-runtime";
 var SIDEBAR_COOKIE_NAME = "sidebar_state";
 var SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7;
 var SIDEBAR_WIDTH = "16rem";
@@ -554,7 +757,7 @@ function SidebarProvider({
     }),
     [state, open, setOpen, isMobile, openMobile, setOpenMobile, toggleSidebar]
   );
-  return /* @__PURE__ */ jsx8(SidebarContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx8(TooltipProvider, { delayDuration: 0, children: /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(SidebarContext.Provider, { value: contextValue, children: /* @__PURE__ */ jsx12(TooltipProvider, { delayDuration: 0, children: /* @__PURE__ */ jsx12(
     "div",
     {
       "data-slot": "sidebar-wrapper",
@@ -578,8 +781,9 @@ function Sidebar({
   ...props
 }) {
   const { isMobile, state, openMobile, setOpenMobile } = useSidebar();
+  const Surface = variant === "floating" ? Panel : "div";
   if (collapsible === "none") {
-    return /* @__PURE__ */ jsx8(
+    return /* @__PURE__ */ jsx12(
       "div",
       {
         "data-slot": "sidebar",
@@ -590,7 +794,7 @@ function Sidebar({
     );
   }
   if (isMobile) {
-    return /* @__PURE__ */ jsx8(Sheet, { open: openMobile, onOpenChange: setOpenMobile, ...props, children: /* @__PURE__ */ jsxs4(
+    return /* @__PURE__ */ jsx12(Sheet, { open: openMobile, onOpenChange: setOpenMobile, ...props, children: /* @__PURE__ */ jsxs6(
       SheetContent,
       {
         "data-sidebar": "sidebar",
@@ -602,16 +806,16 @@ function Sidebar({
         },
         side,
         children: [
-          /* @__PURE__ */ jsxs4(SheetHeader, { className: "sr-only", children: [
-            /* @__PURE__ */ jsx8(SheetTitle, { children: "Sidebar" }),
-            /* @__PURE__ */ jsx8(SheetDescription, { children: "Displays the mobile sidebar." })
+          /* @__PURE__ */ jsxs6(SheetHeader, { className: "sr-only", children: [
+            /* @__PURE__ */ jsx12(SheetTitle, { children: "Sidebar" }),
+            /* @__PURE__ */ jsx12(SheetDescription, { children: "Displays the mobile sidebar." })
           ] }),
-          /* @__PURE__ */ jsx8("div", { className: "flex h-full w-full flex-col", children })
+          /* @__PURE__ */ jsx12("div", { className: "flex h-full w-full flex-col", children })
         ]
       }
     ) });
   }
-  return /* @__PURE__ */ jsxs4(
+  return /* @__PURE__ */ jsxs6(
     "div",
     {
       className: "group peer hidden text-sidebar-foreground md:block",
@@ -621,7 +825,7 @@ function Sidebar({
       "data-side": side,
       "data-slot": "sidebar",
       children: [
-        /* @__PURE__ */ jsx8(
+        /* @__PURE__ */ jsx12(
           "div",
           {
             "data-slot": "sidebar-gap",
@@ -633,7 +837,7 @@ function Sidebar({
             )
           }
         ),
-        /* @__PURE__ */ jsx8(
+        /* @__PURE__ */ jsx12(
           "div",
           {
             "data-slot": "sidebar-container",
@@ -645,12 +849,12 @@ function Sidebar({
               className
             ),
             ...props,
-            children: /* @__PURE__ */ jsx8(
-              "div",
+            children: /* @__PURE__ */ jsx12(
+              Surface,
               {
                 "data-sidebar": "sidebar",
                 "data-slot": "sidebar-inner",
-                className: "flex h-full w-full flex-col bg-sidebar group-data-[variant=floating]:rounded-lg group-data-[variant=floating]:border group-data-[variant=floating]:border-sidebar-border group-data-[variant=floating]:shadow-sm",
+                className: cn("flex h-full w-full flex-col", variant !== "floating" && "bg-sidebar"),
                 children
               }
             )
@@ -661,7 +865,7 @@ function Sidebar({
   );
 }
 function SidebarHeader({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "div",
     {
       "data-slot": "sidebar-header",
@@ -672,7 +876,7 @@ function SidebarHeader({ className, ...props }) {
   );
 }
 function SidebarFooter({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "div",
     {
       "data-slot": "sidebar-footer",
@@ -683,7 +887,7 @@ function SidebarFooter({ className, ...props }) {
   );
 }
 function SidebarContent({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "div",
     {
       "data-slot": "sidebar-content",
@@ -697,7 +901,7 @@ function SidebarContent({ className, ...props }) {
   );
 }
 function SidebarGroup({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "div",
     {
       "data-slot": "sidebar-group",
@@ -708,7 +912,7 @@ function SidebarGroup({ className, ...props }) {
   );
 }
 function SidebarMenu({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "ul",
     {
       "data-slot": "sidebar-menu",
@@ -719,7 +923,7 @@ function SidebarMenu({ className, ...props }) {
   );
 }
 function SidebarMenuItem({ className, ...props }) {
-  return /* @__PURE__ */ jsx8(
+  return /* @__PURE__ */ jsx12(
     "li",
     {
       "data-slot": "sidebar-menu-item",
@@ -758,9 +962,9 @@ function SidebarMenuButton({
   className,
   ...props
 }) {
-  const Comp = asChild ? Slot2.Root : "button";
+  const Comp = asChild ? Slot4.Root : "button";
   const { isMobile, state } = useSidebar();
-  const button2 = /* @__PURE__ */ jsx8(
+  const button2 = /* @__PURE__ */ jsx12(
     Comp,
     {
       "data-slot": "sidebar-menu-button",
@@ -771,50 +975,61 @@ function SidebarMenuButton({
       ...props
     }
   );
-  if (!tooltip) {
-    return button2;
-  }
-  if (typeof tooltip === "string") {
-    tooltip = {
-      children: tooltip
-    };
-  }
-  return /* @__PURE__ */ jsxs4(Tooltip, { children: [
-    /* @__PURE__ */ jsx8(TooltipTrigger, { asChild: true, children: button2 }),
-    /* @__PURE__ */ jsx8(TooltipContent, { side: "right", align: "center", hidden: state !== "collapsed" || isMobile, ...tooltip })
-  ] });
+  if (!tooltip) return button2;
+  const { children, ...hint } = typeof tooltip === "string" ? { children: tooltip } : tooltip;
+  return /* @__PURE__ */ jsx12(Hint, { side: "right", align: "center", hidden: state !== "collapsed" || isMobile, ...hint, content: children, children: button2 });
+}
+function SidebarMenuAction({
+  className,
+  asChild = false,
+  showOnHover = false,
+  ...props
+}) {
+  const Comp = asChild ? Slot4.Root : "button";
+  return /* @__PURE__ */ jsx12(
+    Comp,
+    {
+      "data-slot": "sidebar-menu-action",
+      "data-sidebar": "menu-action",
+      className: cn(
+        "absolute top-1/2 right-1 flex aspect-square w-5 -translate-y-1/2 items-center justify-center rounded-md p-0 text-sidebar-foreground ring-sidebar-ring outline-hidden transition-transform peer-hover/menu-button:text-sidebar-accent-foreground hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 [&>svg]:size-4 [&>svg]:shrink-0",
+        // Increases the hit area of the button on mobile.
+        "after:absolute after:-inset-2 md:after:hidden",
+        "group-data-[collapsible=icon]:hidden",
+        showOnHover && "group-focus-within/menu-item:opacity-100 group-hover/menu-item:opacity-100 peer-data-[active=true]/menu-button:text-sidebar-accent-foreground data-[state=open]:opacity-100 md:opacity-0",
+        className
+      ),
+      ...props
+    }
+  );
 }
 
 // src/react/studio.tsx
-import { jsx as jsx9, jsxs as jsxs5 } from "react/jsx-runtime";
+import { Fragment as Fragment2, jsx as jsx13, jsxs as jsxs7 } from "react/jsx-runtime";
 var CONNECTION = {
   connected: { icon: PlugZap, tone: "text-success", label: "Runtime connected" },
   connecting: { icon: LoaderCircle, tone: "text-warning animate-spin", label: "Connecting to runtime" },
   offline: { icon: Unplug, tone: "text-destructive", label: "Runtime offline" },
   local: { icon: Unplug, tone: "text-faint", label: "No runtime" }
 };
-var PANEL = "rounded-lg border border-sidebar-border bg-sidebar/85 shadow-xl shadow-black/40 backdrop-blur-xl";
-var PANEL_CONTAINER = cn(
-  "[&>[data-slot=sidebar-inner]]:bg-sidebar/85 [&>[data-slot=sidebar-inner]]:shadow-xl [&>[data-slot=sidebar-inner]]:shadow-black/40 [&>[data-slot=sidebar-inner]]:backdrop-blur-xl"
-);
 function StudioFooter({ connection }) {
   const { state, toggleSidebar } = useSidebar();
   const { icon: Status, tone, label } = CONNECTION[connection.phase];
   const Toggle = state === "expanded" ? PanelLeftClose : PanelLeftOpen;
-  return /* @__PURE__ */ jsx9(SidebarFooter, { children: /* @__PURE__ */ jsxs5(SidebarMenu, { children: [
-    /* @__PURE__ */ jsx9(SidebarMenuItem, { children: /* @__PURE__ */ jsxs5(SidebarMenuButton, { tooltip: label, className: "cursor-default hover:bg-transparent active:bg-transparent", children: [
-      /* @__PURE__ */ jsx9(Status, { className: tone }),
-      /* @__PURE__ */ jsx9("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: label })
+  return /* @__PURE__ */ jsx13(SidebarFooter, { children: /* @__PURE__ */ jsxs7(SidebarMenu, { children: [
+    /* @__PURE__ */ jsx13(SidebarMenuItem, { children: /* @__PURE__ */ jsxs7(SidebarMenuButton, { tooltip: label, className: "cursor-default hover:bg-transparent active:bg-transparent", children: [
+      /* @__PURE__ */ jsx13(Status, { className: tone }),
+      /* @__PURE__ */ jsx13("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: label })
     ] }) }),
-    /* @__PURE__ */ jsx9(SidebarMenuItem, { children: /* @__PURE__ */ jsxs5(
+    /* @__PURE__ */ jsx13(SidebarMenuItem, { children: /* @__PURE__ */ jsxs7(
       SidebarMenuButton,
       {
         "aria-label": `${state === "expanded" ? "Collapse" : "Expand"} sidebar`,
         tooltip: `${state === "expanded" ? "Collapse" : "Expand"} sidebar`,
         onClick: toggleSidebar,
         children: [
-          /* @__PURE__ */ jsx9(Toggle, {}),
-          /* @__PURE__ */ jsx9("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: "Collapse" })
+          /* @__PURE__ */ jsx13(Toggle, {}),
+          /* @__PURE__ */ jsx13("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: "Collapse" })
         ]
       }
     ) })
@@ -836,14 +1051,16 @@ function forwardShortcuts(frame) {
   } catch {
   }
 }
-function Studio({ studio }) {
+function Studio({ studio, previewComponent, getConfigFileHref }) {
   useStudio(studio);
-  const [mounted, setMounted] = useState4(false);
-  const [panelsHidden, setPanelsHidden] = useState4(false);
-  const [selected, setSelected] = useState4(studio.tools[0]?.definition.id);
-  const preview = useRef2(null);
+  const { tools, pinned, togglePin } = usePinnedTools(studio);
+  const [mounted, setMounted] = useState7(false);
+  const [panelsHidden, setPanelsHidden] = useState7(false);
+  const [selected, setSelected] = useState7(studio.tools[0]?.definition.id);
+  const preview = useRef3(null);
   const handle = studio.tools.find((tool) => tool.definition.id === selected);
-  useEffect3(() => {
+  const Preview = previewComponent ?? (handle?.definition.previewLayout === "custom" ? "iframe" : PreviewCanvas);
+  useEffect4(() => {
     const onKey = (event) => {
       if (event.defaultPrevented || event.isComposing || event.altKey || !(event.metaKey || event.ctrlKey)) return;
       if (event.key.toLowerCase() !== "b") return;
@@ -864,10 +1081,10 @@ function Studio({ studio }) {
     handle.compare(showSaved);
     postCompare(preview.current?.contentWindow, handle.definition.id, showSaved);
   };
-  useEffect3(() => () => handle?.compare(false), [handle]);
-  const current = useRef2({ handle, compare });
+  useEffect4(() => () => handle?.compare(false), [handle]);
+  const current = useRef3({ handle, compare });
   current.current = { handle, compare };
-  useEffect3(() => {
+  useEffect4(() => {
     const onKey = (event) => {
       if (event.key !== COMPARE_KEY || editable(event.target) || event.repeat) return;
       event.preventDefault();
@@ -885,7 +1102,7 @@ function Studio({ studio }) {
       removeEventListener("blur", release);
     };
   }, []);
-  useEffect3(() => {
+  useEffect4(() => {
     const fromHash = () => {
       const id = decodeURIComponent(location.hash.slice(1));
       if (studio.tools.some((handle2) => handle2.definition.id === id)) setSelected(id);
@@ -897,143 +1114,176 @@ function Studio({ studio }) {
   }, [studio]);
   if (!mounted) return null;
   const sidebarOpen = !document.cookie.split("; ").includes("sidebar_state=false");
-  return /* @__PURE__ */ jsxs5(SidebarProvider, { defaultOpen: sidebarOpen, className: "relative h-svh min-h-0 overflow-hidden font-mono text-xs", children: [
-    handle?.definition.preview ? /* @__PURE__ */ jsx9(
-      "iframe",
-      {
-        "data-slot": "studio-preview",
-        ref: preview,
-        src: handle.definition.preview,
-        onLoad: (event) => forwardShortcuts(event.currentTarget),
-        className: "absolute inset-0 size-full border-0 bg-black"
-      },
-      handle.definition.id
-    ) : /* @__PURE__ */ jsx9("div", { className: "absolute inset-0 grid place-items-center text-faint", children: handle ? "This tool has no preview" : "No tools registered" }),
-    panelsHidden && ["left", "right"].map((side) => {
-      const Chevron = side === "left" ? ChevronRight : ChevronLeft;
-      return /* @__PURE__ */ jsx9(
-        "div",
-        {
-          "data-slot": "studio-panel-edge",
-          "data-side": side,
-          className: cn("group/edge absolute inset-y-0 z-20 w-8", side === "left" ? "left-0" : "right-0"),
-          children: /* @__PURE__ */ jsxs5(Tooltip, { children: [
-            /* @__PURE__ */ jsx9(TooltipTrigger, { asChild: true, children: /* @__PURE__ */ jsx9(
-              Button,
-              {
-                "data-slot": "studio-panel-reveal",
-                variant: "ghost",
-                size: "icon",
-                "aria-label": "Show Studio panels",
-                onClick: () => setPanelsHidden(false),
-                className: cn(
-                  PANEL,
-                  "absolute top-1/2 h-16 w-6 -translate-y-1/2 cursor-pointer px-0 text-sidebar-foreground opacity-0 transition-[translate,opacity] duration-200 ease-out hover:bg-sidebar/95 hover:text-foreground focus:translate-x-0 focus:opacity-100 group-hover/edge:translate-x-0 group-hover/edge:opacity-100 motion-reduce:transition-none [@media(hover:none)]:translate-x-0 [@media(hover:none)]:opacity-100",
-                  side === "left" ? "left-1 -translate-x-[calc(100%+0.25rem)]" : "right-1 translate-x-[calc(100%+0.25rem)]"
-                ),
-                children: /* @__PURE__ */ jsx9(Chevron, { "aria-hidden": true })
-              }
-            ) }),
-            /* @__PURE__ */ jsxs5(
-              TooltipContent,
-              {
-                side: side === "left" ? "right" : "left",
-                sideOffset: 8,
-                className: "flex items-center gap-2",
-                children: [
-                  "Show Studio panels",
-                  /* @__PURE__ */ jsxs5(KbdGroup, { children: [
-                    /* @__PURE__ */ jsx9(Kbd, { children: "\u2318/Ctrl" }),
-                    /* @__PURE__ */ jsx9(Kbd, { children: "B" })
-                  ] })
-                ]
-              }
-            )
-          ] })
-        },
-        side
-      );
-    }),
-    /* @__PURE__ */ jsxs5(
-      Sidebar,
-      {
-        collapsible: "icon",
-        variant: "floating",
-        inert: panelsHidden,
-        "aria-hidden": panelsHidden,
-        className: cn(
-          PANEL_CONTAINER,
-          "transition-[left,right,width,translate] duration-200 ease-out motion-reduce:transition-none",
-          panelsHidden && "-translate-x-[calc(100%+1rem)]"
-        ),
-        children: [
-          /* @__PURE__ */ jsx9(SidebarHeader, { className: "h-10 flex-row items-center overflow-hidden py-0 pr-0 pl-4 transition-[padding] duration-200 ease-out group-data-[collapsible=icon]:pl-[calc(1.5rem-0.875rem*352/144/2)] motion-reduce:transition-none", children: /* @__PURE__ */ jsxs5("span", { className: "flex items-center gap-2.5 text-foreground", children: [
-            /* @__PURE__ */ jsx9(Logo, { className: "h-3.5 w-auto shrink-0" }),
-            /* @__PURE__ */ jsx9("strong", { className: "tracking-[0.08em] whitespace-nowrap", children: "STUDIO" }),
-            /* @__PURE__ */ jsxs5("span", { "data-slot": "studio-version", className: "text-[10px] text-faint group-data-[collapsible=icon]:hidden", children: [
-              "v",
-              version
-            ] })
-          ] }) }),
-          /* @__PURE__ */ jsx9(SidebarContent, { children: /* @__PURE__ */ jsx9(SidebarGroup, { children: /* @__PURE__ */ jsx9(SidebarMenu, { children: studio.tools.map(({ definition, state }) => {
-            const title = definition.title ?? definition.id;
-            return /* @__PURE__ */ jsx9(SidebarMenuItem, { children: /* @__PURE__ */ jsxs5(
-              SidebarMenuButton,
-              {
-                isActive: definition.id === selected,
-                tooltip: title,
-                onClick: () => location.hash = definition.id,
-                children: [
-                  /* @__PURE__ */ jsxs5("span", { className: "relative", children: [
-                    /* @__PURE__ */ jsx9(ToolIcon, { icon: definition.icon, className: "size-4" }),
-                    state?.dirty && /* @__PURE__ */ jsx9(
-                      "span",
-                      {
-                        "aria-label": state.conflict ? "Changed on disk" : "Unsaved",
-                        className: cn(
-                          "absolute -top-0.5 -right-0.5 size-1.5 rounded-full",
-                          state.conflict ? "bg-destructive" : "bg-warning"
-                        )
-                      }
-                    )
+  return /* @__PURE__ */ jsxs7(
+    SidebarProvider,
+    {
+      defaultOpen: sidebarOpen,
+      "data-preview-layout": previewComponent ? "canvas" : handle?.definition.previewLayout ?? "canvas",
+      className: "studio-workspace relative h-svh min-h-0 overflow-hidden text-xs",
+      children: [
+        handle?.definition.preview ? /* @__PURE__ */ jsx13(
+          Preview,
+          {
+            "data-slot": "studio-preview",
+            ref: preview,
+            src: handle.definition.preview,
+            title: handle.definition.title ?? handle.definition.id,
+            onLoad: (event) => forwardShortcuts(event.currentTarget)
+          },
+          handle.definition.id
+        ) : /* @__PURE__ */ jsx13("div", { className: "absolute inset-0 grid place-items-center text-faint", children: handle ? "This tool has no preview" : "No tools registered" }),
+        panelsHidden && ["left", "right"].map((side) => {
+          const Chevron = side === "left" ? ChevronRight : ChevronLeft;
+          return /* @__PURE__ */ jsx13(
+            "div",
+            {
+              "data-slot": "studio-panel-edge",
+              "data-side": side,
+              className: cn("group/edge absolute inset-y-0 z-20 w-8", side === "left" ? "left-0" : "right-0"),
+              children: /* @__PURE__ */ jsx13(
+                Hint,
+                {
+                  side: side === "left" ? "right" : "left",
+                  sideOffset: 8,
+                  className: "flex items-center gap-2",
+                  content: /* @__PURE__ */ jsxs7(Fragment2, { children: [
+                    "Show Studio panels",
+                    " ",
+                    /* @__PURE__ */ jsxs7(KbdGroup, { children: [
+                      /* @__PURE__ */ jsx13(Kbd, { children: "\u2318/Ctrl" }),
+                      /* @__PURE__ */ jsx13(Kbd, { children: "B" })
+                    ] })
                   ] }),
-                  /* @__PURE__ */ jsx9("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: title })
-                ]
-              }
-            ) }, definition.id);
-          }) }) }) }),
-          /* @__PURE__ */ jsx9(StudioFooter, { connection: studio.connection })
-        ]
-      }
-    ),
-    handle && /* @__PURE__ */ jsx9(
-      "aside",
-      {
-        "data-slot": "studio-inspector",
-        inert: panelsHidden,
-        "aria-hidden": panelsHidden,
-        className: cn(
-          PANEL,
-          "absolute inset-y-2 right-2 z-10 flex w-80 flex-col transition-transform duration-200 ease-out motion-reduce:transition-none",
-          panelsHidden && "translate-x-[calc(100%+1rem)]"
+                  children: /* @__PURE__ */ jsx13(Panel, { asChild: true, children: /* @__PURE__ */ jsx13(
+                    Button,
+                    {
+                      "data-slot": "studio-panel-reveal",
+                      variant: "ghost",
+                      size: "icon",
+                      "aria-label": "Show Studio panels",
+                      onClick: () => setPanelsHidden(false),
+                      className: cn(
+                        "absolute top-1/2 h-16 w-6 -translate-y-1/2 cursor-pointer px-0 text-sidebar-foreground opacity-0 transition-[translate,opacity] duration-200 ease-out hover:bg-sidebar/95 hover:text-foreground focus:translate-x-0 focus:opacity-100 group-hover/edge:translate-x-0 group-hover/edge:opacity-100 motion-reduce:transition-none [@media(hover:none)]:translate-x-0 [@media(hover:none)]:opacity-100",
+                        side === "left" ? "left-1 -translate-x-[calc(100%+0.25rem)]" : "right-1 translate-x-[calc(100%+0.25rem)]"
+                      ),
+                      children: /* @__PURE__ */ jsx13(Chevron, { "aria-hidden": true })
+                    }
+                  ) })
+                }
+              )
+            },
+            side
+          );
+        }),
+        /* @__PURE__ */ jsxs7(
+          Sidebar,
+          {
+            collapsible: "icon",
+            variant: "floating",
+            inert: panelsHidden,
+            "aria-hidden": panelsHidden,
+            className: cn(
+              "transition-[left,right,width,translate] duration-200 ease-out motion-reduce:transition-none",
+              panelsHidden && "-translate-x-[calc(100%+1rem)]"
+            ),
+            children: [
+              /* @__PURE__ */ jsx13(SidebarHeader, { className: "h-10 flex-row items-center overflow-hidden py-0 pr-0 pl-4 transition-[padding] duration-200 ease-out group-data-[collapsible=icon]:pl-[calc(1.5rem-0.875rem*352/144/2)] motion-reduce:transition-none", children: /* @__PURE__ */ jsxs7("span", { className: "flex items-center gap-2.5 text-foreground", children: [
+                /* @__PURE__ */ jsx13(Logo, { className: "h-3.5 w-auto shrink-0" }),
+                /* @__PURE__ */ jsx13("strong", { className: "tracking-[0.08em] whitespace-nowrap", children: "STUDIO" }),
+                /* @__PURE__ */ jsxs7("span", { "data-slot": "studio-version", className: "text-[10px] text-faint group-data-[collapsible=icon]:hidden", children: [
+                  "v",
+                  version
+                ] })
+              ] }) }),
+              /* @__PURE__ */ jsx13(SidebarContent, { children: /* @__PURE__ */ jsx13(SidebarGroup, { children: /* @__PURE__ */ jsx13(SidebarMenu, { children: tools.map(({ definition, state }) => {
+                const title = definition.title ?? definition.id;
+                const isPinned = pinned.has(definition.id);
+                const pinLabel = `${isPinned ? "Unpin" : "Pin"} ${title}`;
+                return /* @__PURE__ */ jsxs7(SidebarMenuItem, { children: [
+                  /* @__PURE__ */ jsxs7(
+                    SidebarMenuButton,
+                    {
+                      isActive: definition.id === selected,
+                      tooltip: title,
+                      onClick: () => location.hash = definition.id,
+                      children: [
+                        /* @__PURE__ */ jsxs7("span", { className: "relative", children: [
+                          /* @__PURE__ */ jsx13(ToolIcon, { icon: definition.icon, className: "size-4" }),
+                          state?.dirty && /* @__PURE__ */ jsx13(
+                            "span",
+                            {
+                              "aria-label": state.conflict ? "Changed on disk" : "Unsaved",
+                              className: cn(
+                                "absolute -top-0.5 -right-0.5 size-1.5 rounded-full",
+                                state.conflict ? "bg-destructive" : "bg-warning"
+                              )
+                            }
+                          )
+                        ] }),
+                        /* @__PURE__ */ jsx13("span", { className: "text-clip! group-data-[collapsible=icon]:hidden", children: title })
+                      ]
+                    }
+                  ),
+                  /* @__PURE__ */ jsx13(Hint, { content: pinLabel, side: "right", children: /* @__PURE__ */ jsx13(
+                    SidebarMenuAction,
+                    {
+                      type: "button",
+                      "aria-label": pinLabel,
+                      "aria-pressed": isPinned,
+                      showOnHover: !isPinned,
+                      onClick: () => togglePin(definition.id),
+                      className: cn(
+                        "cursor-pointer [&>svg]:size-3 [@media(hover:none)]:opacity-100",
+                        isPinned && "text-sidebar-primary"
+                      ),
+                      children: /* @__PURE__ */ jsx13(Pin2, { "aria-hidden": true, fill: isPinned ? "currentColor" : "none" })
+                    }
+                  ) })
+                ] }, definition.id);
+              }) }) }) }),
+              /* @__PURE__ */ jsx13(StudioFooter, { connection: studio.connection })
+            ]
+          }
         ),
-        children: /* @__PURE__ */ jsx9(Inspector, { studio, handle, onCompare: compare }, handle.definition.id)
-      }
-    )
-  ] });
+        handle && /* @__PURE__ */ jsx13(Panel, { asChild: true, children: /* @__PURE__ */ jsx13(
+          "aside",
+          {
+            "data-slot": "studio-inspector",
+            inert: panelsHidden,
+            "aria-hidden": panelsHidden,
+            className: cn(
+              "absolute inset-y-2 right-2 z-10 flex w-(--studio-inspector-width) flex-col gap-1 p-1 transition-transform duration-200 ease-out motion-reduce:transition-none",
+              panelsHidden && "translate-x-[calc(100%+1rem)]"
+            ),
+            children: /* @__PURE__ */ jsx13(
+              Inspector,
+              {
+                studio,
+                handle,
+                onCompare: compare,
+                fileHref: getConfigFileHref?.(handle.definition.file)
+              },
+              handle.definition.id
+            )
+          }
+        ) })
+      ]
+    }
+  );
 }
 
 // src/react/command-menu.tsx
+import { Pin as Pin3 } from "lucide-react";
 import { Dialog } from "radix-ui";
-import { useEffect as useEffect4, useRef as useRef3, useState as useState5 } from "react";
+import { useEffect as useEffect5, useRef as useRef4, useState as useState8 } from "react";
 
 // src/react/ui/command.tsx
 import * as React3 from "react";
 import { Command as CommandPrimitive } from "cmdk";
 import { SearchIcon } from "lucide-react";
-import { jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs8 } from "react/jsx-runtime";
 function Command({ className, ...props }) {
-  return /* @__PURE__ */ jsx10(
+  return /* @__PURE__ */ jsx14(
     CommandPrimitive,
     {
       "data-slot": "command",
@@ -1046,9 +1296,9 @@ function Command({ className, ...props }) {
   );
 }
 var CommandInput = React3.forwardRef(function CommandInput2({ className, ...props }, ref) {
-  return /* @__PURE__ */ jsxs6("div", { "data-slot": "command-input-wrapper", className: "flex h-9 items-center gap-2 border-b px-3", children: [
-    /* @__PURE__ */ jsx10(SearchIcon, { "aria-hidden": true, className: "size-4 shrink-0 opacity-50" }),
-    /* @__PURE__ */ jsx10(
+  return /* @__PURE__ */ jsxs8("div", { "data-slot": "command-input-wrapper", className: "flex h-9 items-center gap-2 border-b px-3", children: [
+    /* @__PURE__ */ jsx14(SearchIcon, { "aria-hidden": true, className: "size-4 shrink-0 opacity-50" }),
+    /* @__PURE__ */ jsx14(
       CommandPrimitive.Input,
       {
         ref,
@@ -1063,7 +1313,7 @@ var CommandInput = React3.forwardRef(function CommandInput2({ className, ...prop
   ] });
 });
 function CommandList({ className, ...props }) {
-  return /* @__PURE__ */ jsx10(
+  return /* @__PURE__ */ jsx14(
     CommandPrimitive.List,
     {
       "data-slot": "command-list",
@@ -1073,10 +1323,10 @@ function CommandList({ className, ...props }) {
   );
 }
 function CommandEmpty({ ...props }) {
-  return /* @__PURE__ */ jsx10(CommandPrimitive.Empty, { "data-slot": "command-empty", className: "py-6 text-center text-sm", ...props });
+  return /* @__PURE__ */ jsx14(CommandPrimitive.Empty, { "data-slot": "command-empty", className: "py-6 text-center text-sm", ...props });
 }
 function CommandItem({ className, ...props }) {
-  return /* @__PURE__ */ jsx10(
+  return /* @__PURE__ */ jsx14(
     CommandPrimitive.Item,
     {
       "data-slot": "command-item",
@@ -1090,12 +1340,13 @@ function CommandItem({ className, ...props }) {
 }
 
 // src/react/command-menu.tsx
-import { jsx as jsx11, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx15, jsxs as jsxs9 } from "react/jsx-runtime";
 function StudioCommandMenu({ studio, studioPath = "/studio", navigate }) {
-  const [open, setOpen] = useState5(false);
-  const opener = useRef3(null);
-  const input = useRef3(null);
-  useEffect4(() => {
+  const { tools, pinned } = usePinnedTools(studio);
+  const [open, setOpen] = useState8(false);
+  const opener = useRef4(null);
+  const input = useRef4(null);
+  useEffect5(() => {
     if (window.frameElement?.getAttribute("data-slot") === "studio-preview") return;
     const onKey = (event) => {
       if (event.defaultPrevented || event.isComposing || event.altKey || !(event.metaKey || event.ctrlKey)) return;
@@ -1119,9 +1370,9 @@ function StudioCommandMenu({ studio, studioPath = "/studio", navigate }) {
       window.location.assign(target.href);
     }
   };
-  return /* @__PURE__ */ jsx11(Dialog.Root, { open, onOpenChange: setOpen, children: /* @__PURE__ */ jsxs7(Dialog.Portal, { children: [
-    /* @__PURE__ */ jsx11(Dialog.Overlay, { "data-slot": "studio-command-overlay" }),
-    /* @__PURE__ */ jsxs7(
+  return /* @__PURE__ */ jsx15(Dialog.Root, { open, onOpenChange: setOpen, children: /* @__PURE__ */ jsxs9(Dialog.Portal, { children: [
+    /* @__PURE__ */ jsx15(Dialog.Overlay, { "data-slot": "studio-command-overlay" }),
+    /* @__PURE__ */ jsxs9(
       Dialog.Content,
       {
         "data-slot": "studio-command-menu",
@@ -1135,43 +1386,44 @@ function StudioCommandMenu({ studio, studioPath = "/studio", navigate }) {
           opener.current?.focus();
         },
         children: [
-          /* @__PURE__ */ jsxs7("div", { "data-slot": "studio-command-heading", children: [
-            /* @__PURE__ */ jsxs7(Dialog.Title, { "aria-label": "Studio tools", children: [
-              /* @__PURE__ */ jsx11(Logo, { "aria-hidden": true }),
-              /* @__PURE__ */ jsx11("strong", { children: "STUDIO" })
+          /* @__PURE__ */ jsxs9("div", { "data-slot": "studio-command-heading", children: [
+            /* @__PURE__ */ jsxs9(Dialog.Title, { "aria-label": "Studio tools", children: [
+              /* @__PURE__ */ jsx15(Logo, { "aria-hidden": true }),
+              /* @__PURE__ */ jsx15("strong", { children: "STUDIO" })
             ] }),
-            /* @__PURE__ */ jsx11(Dialog.Close, { "aria-label": "Close tool menu", children: /* @__PURE__ */ jsx11(Kbd, { children: "esc" }) })
+            /* @__PURE__ */ jsx15(Dialog.Close, { "aria-label": "Close tool menu", children: /* @__PURE__ */ jsx15(Kbd, { children: "esc" }) })
           ] }),
-          /* @__PURE__ */ jsx11(Dialog.Description, { "data-slot": "studio-command-description", children: "Open a tool in Studio." }),
-          /* @__PURE__ */ jsxs7(Command, { label: "Studio tools", loop: true, vimBindings: false, children: [
-            /* @__PURE__ */ jsx11(CommandInput, { ref: input, placeholder: "Search tools\u2026" }),
-            /* @__PURE__ */ jsxs7(CommandList, { children: [
-              /* @__PURE__ */ jsx11(CommandEmpty, { children: studio.tools.length ? "No tools found." : "No tools registered yet." }),
-              studio.tools.map(({ definition: tool }) => /* @__PURE__ */ jsxs7(
+          /* @__PURE__ */ jsx15(Dialog.Description, { "data-slot": "studio-command-description", children: "Open a tool in Studio." }),
+          /* @__PURE__ */ jsxs9(Command, { label: "Studio tools", loop: true, vimBindings: false, children: [
+            /* @__PURE__ */ jsx15(CommandInput, { ref: input, placeholder: "Search tools\u2026" }),
+            /* @__PURE__ */ jsxs9(CommandList, { children: [
+              /* @__PURE__ */ jsx15(CommandEmpty, { children: studio.tools.length ? "No tools found." : "No tools registered yet." }),
+              tools.map(({ definition: tool }) => /* @__PURE__ */ jsxs9(
                 CommandItem,
                 {
                   value: tool.id,
                   keywords: [tool.title ?? tool.id],
                   onSelect: () => select(tool.id),
                   children: [
-                    /* @__PURE__ */ jsx11(ToolIcon, { icon: tool.icon }),
-                    /* @__PURE__ */ jsx11("span", { "data-slot": "studio-command-label", children: tool.title ?? tool.id })
+                    /* @__PURE__ */ jsx15(ToolIcon, { icon: tool.icon }),
+                    /* @__PURE__ */ jsx15("span", { "data-slot": "studio-command-label", children: tool.title ?? tool.id }),
+                    pinned.has(tool.id) && /* @__PURE__ */ jsx15(Pin3, { "aria-hidden": true })
                   ]
                 },
                 tool.id
               ))
             ] })
           ] }),
-          /* @__PURE__ */ jsxs7("div", { "data-slot": "studio-command-footer", "aria-hidden": true, children: [
-            /* @__PURE__ */ jsxs7("span", { children: [
-              /* @__PURE__ */ jsxs7(KbdGroup, { children: [
-                /* @__PURE__ */ jsx11(Kbd, { children: "\u2191" }),
-                /* @__PURE__ */ jsx11(Kbd, { children: "\u2193" })
+          /* @__PURE__ */ jsxs9("div", { "data-slot": "studio-command-footer", "aria-hidden": true, children: [
+            /* @__PURE__ */ jsxs9("span", { children: [
+              /* @__PURE__ */ jsxs9(KbdGroup, { children: [
+                /* @__PURE__ */ jsx15(Kbd, { children: "\u2191" }),
+                /* @__PURE__ */ jsx15(Kbd, { children: "\u2193" })
               ] }),
               "navigate"
             ] }),
-            /* @__PURE__ */ jsxs7("span", { children: [
-              /* @__PURE__ */ jsx11(Kbd, { children: "\u21B5" }),
+            /* @__PURE__ */ jsxs9("span", { children: [
+              /* @__PURE__ */ jsx15(Kbd, { children: "\u21B5" }),
               " open tool"
             ] })
           ] })
@@ -1180,9 +1432,95 @@ function StudioCommandMenu({ studio, studioPath = "/studio", navigate }) {
     )
   ] }) });
 }
+
+// src/react/select.tsx
+import { Check, ChevronDown, ChevronUp } from "lucide-react";
+import { Select } from "radix-ui";
+import { jsx as jsx16, jsxs as jsxs10 } from "react/jsx-runtime";
+function StudioSelect({ label, title, className, children, ...props }) {
+  return /* @__PURE__ */ jsxs10(Select.Root, { ...props, children: [
+    /* @__PURE__ */ jsxs10(
+      Select.Trigger,
+      {
+        "data-slot": "select-trigger",
+        "aria-label": label,
+        title,
+        className: cn(
+          "border-input text-foreground focus-visible:border-ring focus-visible:ring-ring/50 flex h-7 max-w-full shrink-0 items-center justify-between gap-2 rounded-md border bg-(--field) px-2 text-xs whitespace-nowrap transition-[color,box-shadow] outline-none hover:bg-(--field-hover) focus-visible:ring-2 disabled:cursor-not-allowed disabled:opacity-50 [&>span:first-child]:truncate",
+          className
+        ),
+        children: [
+          /* @__PURE__ */ jsx16(Select.Value, {}),
+          /* @__PURE__ */ jsx16(Select.Icon, { children: /* @__PURE__ */ jsx16(ChevronDown, { className: "shrink-0 text-muted-foreground", size: 14, strokeWidth: 1.5, "aria-hidden": true }) })
+        ]
+      }
+    ),
+    /* @__PURE__ */ jsx16(Select.Portal, { children: /* @__PURE__ */ jsxs10(
+      Select.Content,
+      {
+        className: "relative z-50 max-h-(--radix-select-content-available-height) min-w-(--radix-select-trigger-width) overflow-hidden rounded-md border border-border bg-popover font-(family-name:--studio-font) text-xs font-normal text-popover-foreground shadow-md",
+        "data-slot": "select-content",
+        position: "popper",
+        align: "end",
+        sideOffset: 6,
+        children: [
+          /* @__PURE__ */ jsx16(Select.ScrollUpButton, { className: "flex justify-center py-1", children: /* @__PURE__ */ jsx16(ChevronUp, { size: 14, "aria-hidden": true }) }),
+          /* @__PURE__ */ jsx16(Select.Viewport, { className: "p-1", children }),
+          /* @__PURE__ */ jsx16(Select.ScrollDownButton, { className: "flex justify-center py-1", children: /* @__PURE__ */ jsx16(ChevronDown, { size: 14, "aria-hidden": true }) })
+        ]
+      }
+    ) })
+  ] });
+}
+function StudioSelectItem({ className, children, ...props }) {
+  return /* @__PURE__ */ jsxs10(
+    Select.Item,
+    {
+      "data-slot": "select-item",
+      className: cn(
+        "relative flex min-h-7 cursor-default items-center rounded-sm py-1.5 pr-8 pl-2 outline-none select-none data-[highlighted]:bg-(--field-hover) data-[highlighted]:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
+        className
+      ),
+      ...props,
+      children: [
+        /* @__PURE__ */ jsx16(Select.ItemText, { children }),
+        /* @__PURE__ */ jsx16(Select.ItemIndicator, { className: "absolute right-2", children: /* @__PURE__ */ jsx16(Check, { size: 14, strokeWidth: 1.5, "aria-hidden": true }) })
+      ]
+    }
+  );
+}
+
+// src/react/ui/input.tsx
+import { forwardRef as forwardRef5 } from "react";
+import { jsx as jsx17 } from "react/jsx-runtime";
+var Input = forwardRef5(function Input2({ className, ...props }, ref) {
+  return /* @__PURE__ */ jsx17(
+    "input",
+    {
+      ref,
+      "data-slot": "input",
+      className: cn(
+        "border-input text-foreground placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 h-8 w-full min-w-0 rounded-md border bg-transparent py-1 ps-3 pe-3 text-sm transition-[color,box-shadow] outline-none focus-visible:ring-2 disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      ),
+      ...props
+    }
+  );
+});
 export {
+  CanvasToolbar,
+  PreviewCanvas,
   Studio,
   StudioCommandMenu,
+  Input as StudioInput,
+  Panel as StudioPanel,
+  PanelContent as StudioPanelContent,
+  PanelFooter as StudioPanelFooter,
+  PanelHeader as StudioPanelHeader,
+  StudioSelect,
+  StudioSelectItem,
+  StudioSurface,
+  StudioToolbar,
   useStudio,
   useToolConfig
 };