@jxsuite/studio 10.1.0 → 10.3.0

package/src/studio.ts

@@ -212,6 +212,7 @@ import { setProjectAdopter } from "./services/project-adoption";
 import { setImportHandoff } from "./services/import-seed";
 import { watchConnection } from "./services/connection";
 import { commitTabBuffers, tabBufferUnsaved } from "./services/monaco-buffer";
+import { imageEditorDirty } from "./media/image-editor";
 import { clearTyping } from "./tabs/typing";
 import * as leftPanelMod from "./panels/left-panel";
 import * as tabStrip from "./panels/tab-strip";
@@ -605,12 +606,19 @@ setInsertZoneClickHandler(runInsertZoneAction);
 setFileDropHandler(applyFileDrop);
 // Every upload surface routes through uploadAssets(); refresh the three caches that list project
 // Files afterwards. Injected here because all three modules import from media-upload.
-setMediaChangedHandler(async (dir) => {
+setMediaChangedHandler(async (dir, overwritten) => {
   invalidateMediaCache();
   invalidateLibrary();
   invalidateSiteIndex();
   await loadDirectory(dir);
   renderLeftPanel();
+  /* Bytes replaced IN PLACE change no listing, so nothing above redraws what was already drawn from
+     them. Every pane draws again, and its asset resolver now carries the path's repaint key. */
+  if (overwritten !== undefined) {
+    for (const pane of workspace.panes) {
+      renderCanvas(pane.id);
+    }
+  }
 });
 // The in-iframe "/" trigger drives the parent-realm slash menu across the bridge.
 setCanvasSlashHandler(canvasSlashHandler);
@@ -677,7 +685,7 @@ document.addEventListener(
  */
 export function hasUnsavedTabs(): boolean {
   for (const tab of workspace.tabs.values()) {
-    if (tab.doc.dirty || tabBufferUnsaved(tab)) {
+    if (tab.doc.dirty || tabBufferUnsaved(tab) || imageEditorDirty(tab)) {
       return true;
     }
   }
@@ -1119,6 +1127,9 @@ if (_projectParam) {
           /* Through `loadDirectory` (inside `loadProjectDirectories`), not `platform.listDirectory`:
              the loader is what reads the `.gitignore` chain governing each directory. */
           await loadProjectDirectories();
+          /* The other two ways into a project subscribe, and this one did not, so a project opened
+             by its URL never heard about a file changing on disk. */
+          ensureFsSync();
           void maybePromptJxsuiteUpdate(siteCtx.sitePath);
         }
 

package/src/surfaces/ai-credentials-form.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://jxsuite.com/schema/v1",
   "$id": "StudioAiCredentialsForm",
-  "$description": "The AI provider credentials form every gate embeds below the keyless offer: a key, a model, an endpoint, and the two buttons that keep or abandon them. Everything here is a projection — `ui/ai-credentials-form.ts` keeps the drafts, decides what a fetch is sent with, what Save actually persists and whether there is anything to Save or Cancel at all. This document never reads a setting and never calls the proxy.",
+  "$description": "The AI provider credentials form every gate embeds below the keyless offer: a provider family (only where the backend reaches more than one), a key, a model, an endpoint, and the two buttons that keep or abandon them. Everything here is a projection — `ui/ai-credentials-form.ts` keeps the drafts, decides what a fetch is sent with, what Save actually persists and whether there is anything to Save or Cancel at all. This document never reads a setting and never calls the proxy.",
   "tagName": "div",
   "attributes": {
     "part": "ai-creds-form",
@@ -32,7 +32,7 @@
       "fontWeight": "500",
       "fontSize": "var(--jx-text-sm)"
     },
-    "& [part=\"key\"], & [part=\"model\"], & [part=\"endpoint\"]": {
+    "& [part=\"provider\"], & [part=\"key\"], & [part=\"model\"], & [part=\"endpoint\"]": {
       "$description": "Every control takes the column's width; the kit's fields are inline-flex by default.",
       "width": "100%"
     },
@@ -73,6 +73,54 @@
       },
       "textContent": "${state.intro}"
     },
+    {
+      "$description": "The family the key belongs to (specs/ai.md §2.6), drawn only where it is a choice: the backend's models route lists more than the OpenAI-compatible family, or the stored or drafted family is already another one, so a reader can always switch back. A backend that lists nothing reaches the OpenAI-compatible family alone and forwards every key there, so offering Claude to it would send a Claude key to OpenAI. Above the key because it decides what the key is.",
+      "tagName": "div",
+      "attributes": {
+        "part": "provider-slot",
+        "role": "none"
+      },
+      "style": {
+        "display": "contents"
+      },
+      "$switch": {
+        "$ref": "#/state/showProvider"
+      },
+      "cases": {
+        "true": {
+          "tagName": "jx-select",
+          "attributes": {
+            "part": "provider"
+          },
+          "$props": {
+            "label": "Provider",
+            "size": "sm",
+            "options": {
+              "$ref": "#/state/providerOptions"
+            },
+            "value": {
+              "$ref": "#/state/providerDraft"
+            }
+          },
+          "onchange": {
+            "$prototype": "Function",
+            "body": [
+              {
+                "operator": "call",
+                "target": {
+                  "$ref": "#/state/setProvider"
+                },
+                "value": [
+                  {
+                    "$ref": "event#/target/value"
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      }
+    },
     {
       "tagName": "jx-textfield",
       "attributes": {
@@ -82,7 +130,9 @@
         "label": "AI provider key",
         "type": "password",
         "size": "sm",
-        "placeholder": "sk-… or any compatible key",
+        "placeholder": {
+          "$ref": "#/state/keyPlaceholder"
+        },
         "value": {
           "$ref": "#/state/keyDraft"
         }
@@ -120,7 +170,9 @@
       "$props": {
         "label": "Model ID",
         "size": "sm",
-        "placeholder": "Model ID (e.g. gpt-4o, claude-sonnet-4-20250514, etc.)",
+        "placeholder": {
+          "$ref": "#/state/modelPlaceholder"
+        },
         "allowsCustomValue": true,
         "value": {
           "$ref": "#/state/modelDraft"
@@ -231,7 +283,9 @@
       "$props": {
         "label": "Endpoint",
         "size": "sm",
-        "placeholder": "Endpoint (optional, e.g. http://localhost:11434/v1)",
+        "placeholder": {
+          "$ref": "#/state/endpointPlaceholder"
+        },
         "value": {
           "$ref": "#/state/baseUrlDraft"
         }

package/src/surfaces/ai-credentials-form.ts

@@ -2,7 +2,7 @@
 /**
  * The AI provider credentials form as a mounted document.
  *
- * `ui/ai-credentials-form.ts` is the flow — it holds the three drafts, decides which credentials a
+ * `ui/ai-credentials-form.ts` is the flow — it holds the drafts, decides which credentials a
  * listing is made with, what Save persists and re-reads, and whether there is anything to commit —
  * and this is the surface it draws into.
  *
@@ -37,10 +37,22 @@ registerSurface("ai-credentials-form", credentialsDoc);
 export interface AiCredentialsView {
   /** The line under the title: where the key goes, and where it does not. */
   intro: string;
-  /** The three drafts, exactly as the flow holds them. */
+  /** The drafts, exactly as the flow holds them. */
+  providerDraft: string;
   keyDraft: string;
   modelDraft: string;
   baseUrlDraft: string;
+  /**
+   * Whether the provider picker is drawn: the backend reaches another family, or the drafted or
+   * stored family already is one (specs/ai.md §2.6).
+   */
+  showProvider: boolean;
+  /** The families the picker offers. */
+  providerOptions: SurfaceOption[];
+  /** What each field says while it is empty; they follow the drafted family. */
+  keyPlaceholder: string;
+  modelPlaceholder: string;
+  endpointPlaceholder: string;
   /** The catalogue the last successful listing returned; empty draws no chevron on the field. */
   models: SurfaceOption[];
   /** A listing is in flight: the button says so and refuses a second one. */
@@ -59,6 +71,7 @@ export interface AiCredentialsView {
 
 /** Everything the reader can do here. */
 export interface AiCredentialsActions {
+  setProvider: (value: string) => void;
   setKey: (value: string) => void;
   setModel: (value: string) => void;
   setBaseUrl: (value: string) => void;

package/src/surfaces/commandbar.ts

@@ -57,7 +57,7 @@ import {
   openSettingsMenu,
   SETTINGS_MENU_PLACEMENT,
 } from "../panels/settings-menu";
-import { WORKSPACES } from "../workspace/workspace-ids";
+import { SWITCHER_WORKSPACES } from "../workspace/workspace-ids";
 import type { WorkspaceId } from "../workspace/workspace-ids";
 import commandbarDoc from "./commandbar.json";
 import type { PresenceProjection } from "../collab/presence-chips";
@@ -584,7 +584,11 @@ function projectSegments(tab: Tab | null): SegmentProjection[] {
 }
 
 /**
- * `Design · Content · Media · Styles · Publish`: the five workspaces, as a tablist.
+ * `Design · Content · Media · Styles · Publish`: the five switcher workspaces, as a tablist.
+ *
+ * Project Settings is a workspace too, and is not here: it is reached from its links (the gear
+ * menu's row, ⌘⇧, and every `settings.open` deep link), so while it is on screen no tab is selected
+ * and any of these five leaves it (studio.md §22.2).
  *
  * Each tab RUNS `view.setWorkspace`, so the click, ⌘1–5, the palette row and a script all take the
  * same path, and the selected tab is `shell.workspace` rather than a second record of it. Publish
@@ -598,7 +602,7 @@ function projectWorkspaces(registry: CommandRegistry | null): WorkspaceTabProjec
     return [];
   }
   const dirty = shell.git.status?.files.length ?? 0;
-  return WORKSPACES.map((entry) => {
+  return SWITCHER_WORKSPACES.map((entry) => {
     const badge = entry.id === "publish" && dirty > 0 ? String(dirty) : "";
     const chord = registry.keymap.formatBinding(`workspace.focus.${entry.id}`);
     const named = chord ? `${entry.title} (${chord})` : entry.title;