@jxsuite/studio 5.2.0 → 5.4.0

package/dist/chunks/{studio-01jeck2y.js → studio-m58xn8at.js}

@@ -21,17 +21,17 @@ import {
   activateTab2,
   moveTabToPane2,
   renameTab2
-} from "./studio-ez11dmdh.js";
+} from "./studio-dgdm6vvt.js";
 import {
   registerSurface,
   mountSurface,
   runReported,
   runActiveReported,
   showPromptDialog2
-} from "./studio-ympe0n7a.js";
+} from "./studio-ag3z6shb.js";
 import {
   activeRegistry
-} from "./studio-p6pmwkvh.js";
+} from "./studio-3nprwbd9.js";
 import {
   reactive,
   now,
@@ -45,7 +45,7 @@ import {
 import {
   getPlatform2,
   hasPlatform2
-} from "./studio-6nzaktvy.js";
+} from "./studio-6pwn9j8c.js";
 import {
   loadFormats2,
   refreshFormats2,
@@ -55,16 +55,16 @@ import {
   noFormatError2,
   formatForPath2,
   documentExtensions2
-} from "./studio-28vs5k2y.js";
+} from "./studio-9vsvz7w7.js";
 import {
   resetIgnoreCache,
   ensureIgnoreLayers,
   isIgnoredEntry,
   markLocalMutation2
-} from "./studio-4c041r8y.js";
+} from "./studio-40z39dme.js";
 import {
   invalidateUsages2
-} from "./studio-nq5yf5mp.js";
+} from "./studio-557bmn0x.js";
 import {
   parseJsonDocument,
   restoreSession,
@@ -72,27 +72,27 @@ import {
   markSessionRestored,
   setActivityTab,
   resetProjectShell
-} from "./studio-mpzwze9x.js";
+} from "./studio-mfkh1q8d.js";
 import {
   SETTINGS,
   readStoredSetting,
   setSetting
-} from "./studio-z2smx5ce.js";
+} from "./studio-yxmmjy2a.js";
 import {
   showProgressModal
-} from "./studio-y4f9fdge.js";
+} from "./studio-4998spet.js";
 import {
   registerPanel
-} from "./studio-x72j58vw.js";
+} from "./studio-fqpkpq1t.js";
 import {
   disarmPreviewOverlay,
   parseSourceForPath2,
   confirmFileDelete2,
   renamePromptMessage2
-} from "./studio-x10fp4tp.js";
+} from "./studio-y49b6mjv.js";
 import {
   loadComponentRegistry2
-} from "./studio-zjjde71a.js";
+} from "./studio-gjj4bbfx.js";
 import {
   combine,
   dropTargetForElements2,
@@ -106,27 +106,27 @@ import {
   isViewableMedia,
   openMediaTab,
   cleanupGitPanel2
-} from "./studio-vt0tj32j.js";
+} from "./studio-apv9x70c.js";
 import {
   uploadAccept,
   isImage,
   uploadAssets
-} from "./studio-en82c639.js";
+} from "./studio-sceg8ws0.js";
 import {
   openCsvGridTab,
   openPagesGrid
-} from "./studio-t3adrr56.js";
+} from "./studio-9wm0xzpf.js";
 import {
   openMenu2
-} from "./studio-qa7fzxan.js";
+} from "./studio-mt79tn56.js";
 import {
   listWindow,
   revealListRow,
   watchListWindow
-} from "./studio-38emantv.js";
+} from "./studio-a5h5j33a.js";
 import {
   collectionOfPath
-} from "./studio-hdc2jt3z.js";
+} from "./studio-5w26wza5.js";
 import {
   __preload
 } from "./studio-5te5tqng.js";
@@ -366,7 +366,7 @@ var files_panel_default = {
     fontSize: "var(--jx-text-md)",
     color: "var(--fg)",
     '& [part="empty"]': {
-      $description: "The two states that are not a tree. They are two states and not one sentence: a window with no project at all and a monorepo root that has not been pointed at a site are different situations, and only the second has anything to offer (§11).",
+      $description: "The two states that are not a tree. They are two states and not one sentence: a window with no project at all and a monorepo root that has not been pointed at a site are different situations, and only the second has anything to offer (studio-ui-guidelines.md §11).",
       padding: "var(--jx-space-6)",
       textAlign: "center",
       color: "var(--fg-dim)",
@@ -515,7 +515,7 @@ var files_panel_default = {
                     value: []
                   }
                 ],
-                description: "The declared `project.open` command, run through the registry — not a second opener of this surface's own. It is the one the chord, the palette and the status bar's PROJECT field already run, so a window that opens a project from here reports the outcome the same way they do (§12.5)."
+                description: "The declared `project.open` command, run through the registry — not a second opener of this surface's own. It is the one the chord, the palette and the status bar's PROJECT field already run, so a window that opens a project from here reports the outcome the same way they do (studio-ui-guidelines.md §12.5)."
               },
               children: [
                 {
@@ -567,12 +567,13 @@ var files_panel_default = {
               },
               children: [
                 {
+                  $description: "A row of quiet tools, so NOT compact. A compact group draws every member's frame and fill whatever its quiet says, which is the segmented look a choice wants and not the borderless one a toolbar wants; Spectrum's group here was `compact quiet`, a combination the kit spells as compact=false with its members' default quiet.",
                   tagName: "jx-action-group",
                   attributes: {
                     part: "toolbar-actions"
                   },
                   $props: {
-                    compact: true,
+                    compact: false,
                     label: "File tree actions"
                   },
                   children: [
@@ -2083,7 +2084,7 @@ async function createNewFile(dirPath, renderLeftPanel) {
   const seedable = constrained && collection.isSourceRoot && collection.def.schema !== undefined;
   let created;
   if (seedable) {
-    const { createEntry } = await (__preload("w9qsxa6q"), import("./entry-commands-w9qsxa6q.js"));
+    const { createEntry } = await (__preload("64nb2a9a"), import("./entry-commands-64nb2a9a.js"));
     created = await createEntry(collection.name, { dir: dirPath });
   } else {
     created = await createFileIn2({
@@ -2432,5 +2433,5 @@ function unmountFilesPanel() {
 
 export { ensureDependenciesInstalled, convertTargets, convertTargetExtensions, hydrateRecentProjects, getRecentProjects, addRecentProject, removeRecentProject, clearRecentProjects, getRecentFiles, trackRecentFile, loadDirectory2, loadProject2, openProject2, initProjectRepo2, findHomePage2, openLastSessionOrHome2, renderFilesTemplate2, registerFileTreeDnD2, createFileIn2, notifyMoveOutcome2, settleRename2, openFileInTab2, openFileInPane2, reloadCleanTab2, reloadFileInTab2, registerFilesPanel2 };
 
-//# debugId=7C9C999E902E1E2C64756E2164756E21
-//# sourceMappingURL=studio-01jeck2y.js.map
+//# debugId=3E1906DE2DC8E43564756E2164756E21
+//# sourceMappingURL=studio-m58xn8at.js.map

package/dist/chunks/{studio-mpzwze9x.js → studio-mfkh1q8d.js}

@@ -6,17 +6,6 @@ import {
   pinClock,
   notify2
 } from "./studio-d8z5bajd.js";
-import {
-  getPlatform2
-} from "./studio-6nzaktvy.js";
-import {
-  loadedMonaco
-} from "./studio-28vs5k2y.js";
-import {
-  projectState,
-  setProjectState,
-  requireProjectState
-} from "./studio-m1p9b6c3.js";
 import {
   isWellFormedLocale,
   resolveI18n,
@@ -36,12 +25,23 @@ import {
   workspace2,
   focusPane2,
   setWorkspaceProject2
-} from "./studio-ez11dmdh.js";
+} from "./studio-dgdm6vvt.js";
+import {
+  getPlatform2
+} from "./studio-6pwn9j8c.js";
+import {
+  loadedMonaco
+} from "./studio-9vsvz7w7.js";
+import {
+  projectState,
+  setProjectState,
+  requireProjectState
+} from "./studio-m1p9b6c3.js";
 import {
   SETTINGS,
   readStoredSetting,
   setSetting
-} from "./studio-z2smx5ce.js";
+} from "./studio-yxmmjy2a.js";
 import {
   errorMessage2
 } from "./studio-yxa81f45.js";
@@ -49,7 +49,7 @@ import {
   __preload
 } from "./studio-5te5tqng.js";
 
-// src/files/json-layout.ts
+// ../schema/src/json-layout.ts
 function segment(key) {
   return key.replaceAll("~", "~0").replaceAll("/", "~1");
 }
@@ -1345,7 +1345,7 @@ function extensionsKey(config) {
   return JSON.stringify(config.extensions ?? null);
 }
 async function refreshExtensionSurfaces() {
-  const { loadFormats, refreshExtensionUi, refreshFormats } = await (__preload("f64fnesp"), import("./format-host-f64fnesp.js"));
+  const { loadFormats, refreshExtensionUi, refreshFormats } = await (__preload("mym8qnd0"), import("./format-host-mym8qnd0.js"));
   refreshFormats();
   loadFormats();
   refreshExtensionUi(getPlatform2());
@@ -1582,5 +1582,5 @@ async function updateSiteConfig(patch) {
 
 export { parseJsonDocument, serializeJson, serializeProjectConfig, lendProjectConfigLayout, commitProjectConfig, adoptProjectConfig, getEffectiveMedia, getEffectiveStyle, getEffectiveImports, getEffectiveElements, getEffectiveHead, getEffectiveLocales, invalidateLayoutCache, getEffectiveLayoutPath, resolveLayoutDoc, distributePageIntoLayout, updateSiteConfig, restoreSession, requireNavigatorPanelId, DEFAULT_INSPECTOR_TAB, isInspectorTabId, BOTTOM_TAB_IDS, DEFAULT_BOTTOM_TAB, isBottomTabId, CHROME_THEMES, DOCK_IDS, DOCK_DEFAULT_SIZES, DEFAULT_PANE_SPLIT, PANE_SPLIT_MIN, PANE_SPLIT_MAX, setPaneSplit, shell, persistDocks, persistedSession, markSessionRestored, flushSession, monacoTheme, registerShellSurface, mountShell, setDockCollapsed, setDockSize, setActivityTab, setBottomTab, setChromeTheme, toggleActivityTab, setLayoutSelection, resetProjectShell, registerShellViewCommands };
 
-//# debugId=41F1C61D2E957DBB64756E2164756E21
-//# sourceMappingURL=studio-mpzwze9x.js.map
+//# debugId=36304E8671DE0A5564756E2164756E21
+//# sourceMappingURL=studio-mfkh1q8d.js.map

package/dist/chunks/{studio-etvx9s2g.js → studio-mrh0a92f.js}

@@ -1,7 +1,7 @@
 import {
   getPlatform2,
   hasPlatform2
-} from "./studio-6nzaktvy.js";
+} from "./studio-6pwn9j8c.js";
 import {
   displayTagName,
   isPrivateStateKey
@@ -29,11 +29,7 @@ import {
   surfaceForPane,
   allCanvasSurfaces,
   stageContaining
-} from "./studio-wnsyffg1.js";
-import {
-  loadExtensions2,
-  formatByName2
-} from "./studio-28vs5k2y.js";
+} from "./studio-6vg0x5fz.js";
 import {
   localeDirection,
   primarySelection,
@@ -62,7 +58,11 @@ import {
   paneById2,
   focusPane2,
   isTabActive2
-} from "./studio-ez11dmdh.js";
+} from "./studio-dgdm6vvt.js";
+import {
+  loadExtensions2,
+  formatByName2
+} from "./studio-9vsvz7w7.js";
 import {
   getEffectiveMedia,
   getEffectiveImports,
@@ -74,12 +74,12 @@ import {
   distributePageIntoLayout,
   shell,
   setLayoutSelection
-} from "./studio-mpzwze9x.js";
+} from "./studio-mfkh1q8d.js";
 import {
   componentRegistry2,
   buildComponentInstance2,
   computeRelativePath2
-} from "./studio-zjjde71a.js";
+} from "./studio-gjj4bbfx.js";
 import {
   pureSchemeOf,
   setSkipServerFunctions,
@@ -97,7 +97,7 @@ import {
   POPOVER_TAGS,
   INVOKER_TAGS,
   activeRegistry
-} from "./studio-p6pmwkvh.js";
+} from "./studio-3nprwbd9.js";
 import {
   _defineProperty,
   combine,
@@ -109,7 +109,7 @@ import {
   canvasBaseOrigin,
   documentBase,
   assetContextFor
-} from "./studio-c07s5ckd.js";
+} from "./studio-kwewmhhq.js";
 import {
   rectOf,
   elementAtPoint
@@ -2815,9 +2815,9 @@ function resetZoom(surface = activeCanvasSurface()) {
   applyTransform(surface);
 }
 function centeringOffset(surface, rect) {
-  const wrapRect = rectOf(surface.wrap);
-  const elCenterY = rect.top + rect.height / 2 - wrapRect.top;
-  return wrapRect.height / 2 - elCenterY;
+  const viewport = rectOf(revealScroller(surface) ?? surface.wrap);
+  const elCenterY = rect.top + rect.height / 2 - viewport.top;
+  return viewport.height / 2 - elCenterY;
 }
 function revealScroller(surface) {
   return panelOfSurface(surface)?.scrollContainer ?? null;
@@ -5733,7 +5733,7 @@ function getEditBarAnchorRect2() {
   return null;
 }
 
-export { activeCanvasSurface, tabOfPane, derivationOfPane, surfacesShowingTab, canvasModeOfTab, canvasModeOfPane, activeMediaOfPane, paneOfContainer, tabOfContainer, findDialogDefects, getPreviewNavigateHandler, documentUrlPattern, dynamicRouteParams, pagePathsDef, invalidateParamValues, loadParamValues, isComponentDoc, componentPropEntries, SPAN_FULL_RENDER, SPAN_MOUNT_CANVAS, SPAN_PATCH_BATCH, canvasPerf, recordEscalation, timeSpan, timeSpanAsync, mediaDisplayName, defaultDef, parentCursorToIframe, serializeJxPath, elements_meta_default, getInlineActions, isInlineElement, isEditing, bubbleInlinePath, isSchemeQuery, schemeOfQuery, parseMediaEntries, snapEditWidth, EDIT_WIDTH_MIN, EDIT_WIDTH_SNAP_TOLERANCE, EDIT_CANVAS_GUTTER, declaredWidthOfTab, resolveEditColumnWidth, clearEditWidth, snapTargetsOfTab, setEditWidth, ancestorPopoverPath, ancestorDialogPath, dialogPathFor, stageZoom, canvasPanelEntry, bindCanvasPanels, activateCanvasPanel, observeCenterUntilStable, applyTransform, applyEditZoom, setEditZoom, requestEditZoom, fitToScreen, getFit, setFit, markExplicitZoom, setUserZoom, fitOnCanvasEntry, resetZoom, panToParentRect, canvasBaseViewsFor, canvasBaseViewOf, previewStateOf, setCanvasView, registerCanvasViewCommands, updateActivePanelHeaders, setDragGhost, moveDragGhost, clearDragGhost, disableNativeDragPreview, attachInstruction, extractInstruction, hasElement, enableElement, disableElement, removePackageElements, removeElementRef, renderComponentPreview, registerLayersDnD, registerComponentsDnD, registerElementsDnD, applyDropInstruction, sawIframeDragOver2, allowAutoRequestsOnNextRender2, requestCanvasEval2, flushCanvasEdits2, hostForCanvas2, liveDragHostAt2, beginDragSession2, currentDragSession2, hostDragGeometry2, canvasIdleBlockers2, canvasPointAt2, revealCanvasPath2, revealCanvasPathIn2, measureInCanvas2, adoptCanvasPreviewMode2, postDragMessage2, endDragSession2, clearDropIndicator2, setNativeDragEnterHandler2, setInsertZoneClickHandler2, setFileDropHandler2, setCanvasSlashHandler2, setCanvasContextMenuHandler2, setStylebookHitHandler2, isCaretActive2, setToolbarRefresh2, setCanvasPointerDownHandler2, setIframePatchEscalation2, postPopoverOpen2, postDialogOpen2, postPatchToHosts2, dragHostTab2, releaseCanvasHosts2, mountIframeCanvas2, mountStylebookCanvas2, postColorSchemeToLiveHosts2, postLocaleToLiveHosts2, postRedefineElementToLiveHosts2, postSiteStyleToLiveHosts2, postStyleUpdateToStylebookHosts2, panToStylebookTag2, getEditSnapshot2, setKeymapSource2, postApplyFormat2, postOpenSlash2, commitActiveEditSession2, getEditBarAnchorRect2 };
+export { activeCanvasSurface, tabOfPane, derivationOfPane, surfacesShowingTab, canvasModeOfTab, canvasModeOfPane, activeMediaOfPane, paneOfContainer, tabOfContainer, findDialogDefects, getPreviewNavigateHandler, documentUrlPattern, dynamicRouteParams, pagePathsDef, invalidateParamValues, loadParamValues, isComponentDoc, componentPropEntries, SPAN_FULL_RENDER, SPAN_MOUNT_CANVAS, SPAN_PATCH_BATCH, canvasPerf, recordEscalation, timeSpan, timeSpanAsync, mediaDisplayName, defaultDef, parentCursorToIframe, serializeJxPath, elements_meta_default, getInlineActions, isInlineElement, isEditing, panelOfSurface, bubbleInlinePath, isSchemeQuery, schemeOfQuery, parseMediaEntries, snapEditWidth, EDIT_WIDTH_MIN, EDIT_WIDTH_SNAP_TOLERANCE, EDIT_CANVAS_GUTTER, declaredWidthOfTab, resolveEditColumnWidth, clearEditWidth, snapTargetsOfTab, setEditWidth, ancestorPopoverPath, ancestorDialogPath, dialogPathFor, stageZoom, canvasPanelEntry, bindCanvasPanels, activateCanvasPanel, observeCenterUntilStable, applyTransform, applyEditZoom, setEditZoom, requestEditZoom, fitToScreen, getFit, setFit, markExplicitZoom, setUserZoom, fitOnCanvasEntry, resetZoom, panToParentRect, canvasBaseViewsFor, canvasBaseViewOf, previewStateOf, setCanvasView, registerCanvasViewCommands, updateActivePanelHeaders, setDragGhost, moveDragGhost, clearDragGhost, disableNativeDragPreview, attachInstruction, extractInstruction, hasElement, enableElement, disableElement, removePackageElements, removeElementRef, renderComponentPreview, registerLayersDnD, registerComponentsDnD, registerElementsDnD, applyDropInstruction, sawIframeDragOver2, allowAutoRequestsOnNextRender2, requestCanvasEval2, flushCanvasEdits2, hostForCanvas2, liveDragHostAt2, beginDragSession2, currentDragSession2, hostDragGeometry2, canvasIdleBlockers2, canvasPointAt2, revealCanvasPath2, revealCanvasPathIn2, measureInCanvas2, adoptCanvasPreviewMode2, postDragMessage2, endDragSession2, clearDropIndicator2, setNativeDragEnterHandler2, setInsertZoneClickHandler2, setFileDropHandler2, setCanvasSlashHandler2, setCanvasContextMenuHandler2, setStylebookHitHandler2, isCaretActive2, setToolbarRefresh2, setCanvasPointerDownHandler2, setIframePatchEscalation2, postPopoverOpen2, postDialogOpen2, postPatchToHosts2, dragHostTab2, releaseCanvasHosts2, mountIframeCanvas2, mountStylebookCanvas2, postColorSchemeToLiveHosts2, postLocaleToLiveHosts2, postRedefineElementToLiveHosts2, postSiteStyleToLiveHosts2, postStyleUpdateToStylebookHosts2, panToStylebookTag2, getEditSnapshot2, setKeymapSource2, postApplyFormat2, postOpenSlash2, commitActiveEditSession2, getEditBarAnchorRect2 };
 
-//# debugId=138206C03AA4653064756E2164756E21
-//# sourceMappingURL=studio-etvx9s2g.js.map
+//# debugId=A910716DEA4764AB64756E2164756E21
+//# sourceMappingURL=studio-mrh0a92f.js.map

package/dist/chunks/{studio-qa7fzxan.js → studio-mt79tn56.js}

@@ -1,12 +1,12 @@
 import {
   ensureCaret
-} from "./studio-p6pmwkvh.js";
+} from "./studio-3nprwbd9.js";
 import {
   registerSurface,
   mountSurface,
   getLayerSlot2,
   clearLayerSlot2
-} from "./studio-ympe0n7a.js";
+} from "./studio-ag3z6shb.js";
 import {
   reactive
 } from "./studio-d8z5bajd.js";
@@ -419,4 +419,4 @@ function restoreFocus(opener) {
 export { openMenu2 };
 
 //# debugId=AF40C481EA74291464756E2164756E21
-//# sourceMappingURL=studio-qa7fzxan.js.map
+//# sourceMappingURL=studio-mt79tn56.js.map

package/dist/chunks/{studio-hhskq2mr.js → studio-ne593z1j.js}

@@ -30,10 +30,7 @@ import {
 import {
   view,
   stageContaining
-} from "./studio-wnsyffg1.js";
-import {
-  getPlatform2
-} from "./studio-6nzaktvy.js";
+} from "./studio-6vg0x5fz.js";
 import {
   editorKindForMode,
   hasSelection,
@@ -61,26 +58,29 @@ import {
   jsonClone,
   workspace2,
   activeTab2
-} from "./studio-ez11dmdh.js";
+} from "./studio-dgdm6vvt.js";
+import {
+  getPlatform2
+} from "./studio-6pwn9j8c.js";
 import {
   serializeJson,
   shell,
   setActivityTab
-} from "./studio-mpzwze9x.js";
+} from "./studio-mfkh1q8d.js";
 import {
   KEY_SCOPES,
   checkRecordPlacements,
   registerPanel
-} from "./studio-x72j58vw.js";
+} from "./studio-fqpkpq1t.js";
 import {
   componentRegistry2,
   loadComponentRegistry2,
   computeRelativePath2
-} from "./studio-zjjde71a.js";
+} from "./studio-gjj4bbfx.js";
 import {
   focusItem,
   activeRegistry
-} from "./studio-p6pmwkvh.js";
+} from "./studio-3nprwbd9.js";
 import {
   REGION_ATTR,
   overlayRegion,
@@ -91,13 +91,13 @@ import {
   showPromptDialog2,
   getLayerSlot2,
   clearLayerSlot2
-} from "./studio-ympe0n7a.js";
+} from "./studio-ag3z6shb.js";
 import {
   stylebook_meta_default,
   selectStylebookTag,
   noopCommandDeps,
   defaultCommands
-} from "./studio-2mdbbc76.js";
+} from "./studio-bh47w0cy.js";
 import {
   errorMessage2
 } from "./studio-yxa81f45.js";
@@ -106,6 +106,7 @@ import {
   elements_meta_default,
   getInlineActions,
   isInlineElement,
+  panelOfSurface,
   ancestorPopoverPath,
   ancestorDialogPath,
   disableNativeDragPreview,
@@ -115,7 +116,7 @@ import {
   getEditSnapshot2,
   postApplyFormat2,
   getEditBarAnchorRect2
-} from "./studio-etvx9s2g.js";
+} from "./studio-mrh0a92f.js";
 import {
   draggable2
 } from "./studio-esrxgwh6.js";
@@ -124,19 +125,19 @@ import {
   dataTypeLabel,
   inspectorCommands,
   defCategory
-} from "./studio-a1pswps3.js";
+} from "./studio-rav5bpmp.js";
 import {
   openMenu2
-} from "./studio-qa7fzxan.js";
+} from "./studio-mt79tn56.js";
 import {
   usagesSupported2
-} from "./studio-nq5yf5mp.js";
+} from "./studio-557bmn0x.js";
 import {
   listWindow,
   revealListRow,
   measuredRowHeight,
   watchListWindow
-} from "./studio-38emantv.js";
+} from "./studio-a5h5j33a.js";
 import {
   validateComponentSlots
 } from "./studio-q0a3yk4n.js";
@@ -245,7 +246,7 @@ var panel_stylebook_layers_default = {
       whiteSpace: "nowrap"
     },
     '& [part="empty"]': {
-      $description: "Drawn here rather than borrowed from `panels/empty-state.ts`, which is a lit template a document cannot call. What is kept is the pattern's rules (§11): one sentence saying what the region is for, then where its content comes from.",
+      $description: "Drawn here rather than borrowed from `panels/empty-state.ts`, which is a lit template a document cannot call. What is kept is the pattern's rules (studio-ui-guidelines.md §11): one sentence saying what the region is for, then where its content comes from.",
       display: "flex",
       flexDirection: "column",
       alignItems: "center",
@@ -11857,14 +11858,14 @@ function getConvertTargets(currentTag, isEmpty) {
 var block_action_bar_default = {
   $schema: "https://jxsuite.com/schema/v1",
   $id: "StudioBlockActionBar",
-  $description: "The floating action bar over the canvas selection (plan §3.2 region ⑩, studio-ui-guidelines.md §8.6), as a Jx document over the kit. ONE SHAPE is the whole rule this markup exists to keep: the parent selector, the element badge, the drag handle and every verb are drawn on every selection, and a control that cannot act is DISABLED rather than removed — a toolbar whose buttons move under the cursor is worse than one with a greyed button. Nothing here decides what a verb is called, whether it can act or what its chord reads: `panels/block-action-bar.ts` projects the command registry into `verbs` and `formats`, already resolved to a glyph, a name, a tooltip and a refusal, and this document draws them. The toolbar role, the roving caret and the arrow keys are `jx-action-group`'s, so no keyboard code rides along; Escape is the one key this document claims, because leaving the bar means going back to the canvas and only the host knows where that is. The drag handle is an ISLAND (§9.4): the document draws the node and `surfaces/block-action-bar.ts` attaches the pragmatic-dnd registration to it through `onNodeCreated`. Position is a DECISION measured against the selection rect, so it arrives as two numbers the flow projects — `barX` and `barY` — rather than as a layout this document could compute; the `style` object below binds them, because a style declaration may read state like any other value (spec §9.1).",
+  $description: "The floating action bar over the canvas selection (studio.md §4.4, studio-ui-guidelines.md §8.6), as a Jx document over the kit. ONE SHAPE is the whole rule this markup exists to keep: the parent selector, the element badge, the drag handle and every verb are drawn on every selection, and a control that cannot act is DISABLED rather than removed — a toolbar whose buttons move under the cursor is worse than one with a greyed button. Nothing here decides what a verb is called, whether it can act or what its chord reads: `panels/block-action-bar.ts` projects the command registry into `verbs` and `formats`, already resolved to a glyph, a name, a tooltip and a refusal, and this document draws them. The toolbar role, the roving caret and the arrow keys are `jx-action-group`'s, so no keyboard code rides along; Escape is the one key this document claims, because leaving the bar means going back to the canvas and only the host knows where that is. The drag handle is an ISLAND (studio-ui-guidelines.md §9.4): the document draws the node and `surfaces/block-action-bar.ts` attaches the pragmatic-dnd registration to it through `onNodeCreated`. Position is a DECISION measured against the selection rect, so it arrives as two numbers the flow projects — `barX` and `barY` — rather than as a layout this document could compute; the `style` object below binds them, because a style declaration may read state like any other value (spec.md §9.1).",
   tagName: "div",
   attributes: {
     part: "root",
     role: "none"
   },
   style: {
-    $description: "The `.block-action-bar` rules that used to live in `styles/canvas.css`, re-valued onto the kit's tokens. The bar is `position: fixed` because its anchor is a rect in viewport space that crossed the iframe bridge; the layer it sits in has no clipping, which is why the host clamps it rather than letting overflow do it.\n\nThe two placement properties are declared HERE, bound to the flow's measured numbers. They used to travel as a `style` ATTRIBUTE the flow assembled into one string, on the belief that a document cannot bind a style declaration to state. It can, and always could: a reactive value on a custom property in a rule targeting the element itself is written inline under the author's own name (spec §9.1), which is precisely the attribute that string was hand-writing. The bar reads them by name through the ordinary cascade — the root is `display: contents`, so a custom property set on it inherits down — and `panels/block-action-bar.ts` overrides `--jx-bar-x` on the bar itself when it clamps, because a value set on an element beats one it inherits — which is also why that clamp releases its own previous write before it measures, or the bar would be pinned at the right edge for the rest of the session.",
+    $description: "The `.block-action-bar` rules that used to live in `styles/canvas.css`, re-valued onto the kit's tokens. The bar is `position: fixed` because its anchor is a rect in viewport space that crossed the iframe bridge; the layer it sits in has no clipping, which is why the host clamps it rather than letting overflow do it.\n\nThe two placement properties are declared HERE, bound to the flow's measured numbers. They used to travel as a `style` ATTRIBUTE the flow assembled into one string, on the belief that a document cannot bind a style declaration to state. It can, and always could: a reactive value on a custom property in a rule targeting the element itself is written inline under the author's own name (spec.md §9.1), which is precisely the attribute that string was hand-writing. The bar reads them by name through the ordinary cascade — the root is `display: contents`, so a custom property set on it inherits down — and `panels/block-action-bar.ts` overrides `--jx-bar-x` on the bar itself when it clamps, because a value set on an element beats one it inherits — which is also why that clamp releases its own previous write before it measures, or the bar would be pinned at the right edge for the rest of the session.",
     display: "contents",
     "--jx-bar-x": "${state.barX}px",
     "--jx-bar-y": "${state.barY}px",
@@ -11895,7 +11896,7 @@ var block_action_bar_default = {
       gap: "2px"
     },
     '& [part="tag"] > [part="control"]': {
-      $description: "The element badge. It is a button on every selection and disabled where the tag cannot be changed — a component instance, a repeater — which is §8.6's rule applied to the one control that used to change shape.",
+      $description: "The element badge. It is a button on every selection and disabled where the tag cannot be changed — a component instance, a repeater — which is studio-ui-guidelines.md §8.6's rule applied to the one control that used to change shape.",
       minWidth: "0",
       minHeight: "0",
       maxWidth: "140px",
@@ -11940,7 +11941,7 @@ var block_action_bar_default = {
       }
     },
     '& [part="drag-handle"][aria-disabled="true"]': {
-      $description: "ONE shape (§8.6): the handle is greyed on the document root, never removed — a toolbar whose controls move under the cursor is worse than one with a dead affordance.",
+      $description: "ONE shape (studio-ui-guidelines.md §8.6): the handle is greyed on the document root, never removed — a toolbar whose controls move under the cursor is worse than one with a dead affordance.",
       cursor: "default",
       opacity: "0.3"
     },
@@ -12713,17 +12714,23 @@ function repositionBlockActionBar() {
     }
   });
 }
+var BAR_CLEARANCE = 38;
 function barPosition(anchor) {
-  const stage = activeCanvasSurface().wrap;
-  if (stage) {
-    const wrap = rectOf(stage);
-    if (anchor.top + anchor.height < wrap.top || anchor.top > wrap.bottom) {
-      return null;
-    }
+  const surface = activeCanvasSurface();
+  const viewport = panelOfSurface(surface)?.scrollContainer ?? surface.wrap;
+  const box = viewport ? rectOf(viewport) : null;
+  if (box && (anchor.top + anchor.height < box.top || anchor.top > box.bottom)) {
+    return null;
+  }
+  const ceiling = box ? box.top : 80 - BAR_CLEARANCE;
+  const above = anchor.top - BAR_CLEARANCE;
+  if (above >= ceiling) {
+    return { left: anchor.left, top: above };
   }
+  const below = anchor.top + anchor.height + 4;
   return {
     left: anchor.left,
-    top: anchor.top < 80 ? anchor.top + anchor.height + 4 : anchor.top - 38
+    top: box ? Math.max(box.top, Math.min(below, box.bottom - BAR_CLEARANCE)) : below
   };
 }
 function clampBarToWindow(bar) {
@@ -13738,7 +13745,7 @@ function elementCommands(deps) {
         if (!target?.rerender) {
           return;
         }
-        const { startLayerTitleEdit } = await (__preload("fksbdg4q"), import("./layers-panel-fksbdg4q.js"));
+        const { startLayerTitleEdit } = await (__preload("83a16ytx"), import("./layers-panel-83a16ytx.js"));
         startLayerTitleEdit(target.path, target.rerender);
       }
     }
@@ -14723,7 +14730,7 @@ var panel_outline_default = {
               ]
             },
             empty: {
-              $description: "Drawn here rather than borrowed from `panels/empty-state.ts`, which is a lit template a document cannot call. What is kept is the pattern's rules (guidelines §11): one sentence saying what the region is for, then the one action that fills it.",
+              $description: "Drawn here rather than borrowed from `panels/empty-state.ts`, which is a lit template a document cannot call. What is kept is the pattern's rules (studio-ui-guidelines.md §11): one sentence saying what the region is for, then the one action that fills it.",
               tagName: "div",
               attributes: {
                 part: "empty"
@@ -15527,5 +15534,5 @@ function registerLayersPanel2() {
 
 export { findEnclosingRepeater, convertToComponent, showSlashMenu, showSlashMenuAtRect, dismissSlashMenu, handleSlashMenuKey, parseChord, normalizeChord, chordFromEvent, formatChord, overlappingScopes, chordsInScopes, createCommandRegistry, initBlockActionBar, formatCommands, registerSelectionCommands, dismissLinkPopover, dismissBlockActionBar, suppressBlockActionBar, releaseBlockActionBar, isEditChromeTarget, renderBlockActionBar, ok, find, html2, svg, stringify, stringify2, stringifyPosition, VFile, whitespace, setOpenDialog, setOpenPopover, ensurePopoverRevealWatch, startLayerTitleEdit2, registerLayersPanel2, pasteNode, clipboardCommands, setContextMenuNavigate, liveElementCommands, dismissContextMenu, showContextMenu };
 
-//# debugId=7893C37B2DF2B56864756E2164756E21
-//# sourceMappingURL=studio-hhskq2mr.js.map
+//# debugId=8CEAD773C5C8735E64756E2164756E21
+//# sourceMappingURL=studio-ne593z1j.js.map