@almadar/ui 2.50.1 → 2.52.0

package/dist/avl/index.cjs

@@ -19388,13 +19388,13 @@ var MapViewImpl = React125.lazy(async () => {
     shadowSize: [41, 41]
   });
   L.Marker.prototype.options.icon = defaultIcon;
-  const { useEffect: useEffect87, useRef: useRef87, useCallback: useCallback124, useState: useState124 } = React125__namespace.default;
+  const { useEffect: useEffect88, useRef: useRef88, useCallback: useCallback124, useState: useState124 } = React125__namespace.default;
   const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
   const { useEventBus: useEventBus3 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
   function MapUpdater({ centerLat, centerLng, zoom }) {
     const map = useMap();
-    const prevRef = useRef87({ centerLat, centerLng, zoom });
-    useEffect87(() => {
+    const prevRef = useRef88({ centerLat, centerLng, zoom });
+    useEffect88(() => {
       const prev = prevRef.current;
       if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
         map.setView([centerLat, centerLng], zoom);
@@ -19405,7 +19405,7 @@ var MapViewImpl = React125.lazy(async () => {
   }
   function MapClickHandler({ onMapClick }) {
     const map = useMap();
-    useEffect87(() => {
+    useEffect88(() => {
       if (!onMapClick) return;
       const handler = (e) => {
         onMapClick(e.latlng.lat, e.latlng.lng);
@@ -22118,7 +22118,9 @@ var CodeBlock = React125__namespace.default.memo(
     showLanguageBadge = true,
     maxHeight = "60vh",
     foldable: foldableProp,
-    className
+    className,
+    editable = false,
+    onChange
   }) => {
     const code = typeof rawCode === "string" ? rawCode : String(rawCode ?? "");
     const isOrb = language === "orb";
@@ -22289,7 +22291,37 @@ var CodeBlock = React125__namespace.default.memo(
           ]
         }
       ),
-      /* @__PURE__ */ jsxRuntime.jsx(
+      editable ? (
+        /* GAP-51: editable mode — composes the Textarea atom. Plain text editing,
+           no Prism highlighting overlay (follow-up). The textarea is uncontrolled
+           on the value side: we pass `code` as the initial value and forward
+           every keystroke via onChange — the consumer is responsible for
+           debouncing and re-deriving `code` only after the user stops typing
+           so the cursor doesn't fight a re-render. */
+        /* @__PURE__ */ jsxRuntime.jsx(
+          Textarea,
+          {
+            defaultValue: code,
+            onChange: (e) => onChange?.(e.target.value),
+            spellCheck: false,
+            style: {
+              fontFamily: 'ui-monospace, SFMono-Regular, Menlo, Monaco, "Cascadia Mono", "Courier New", monospace',
+              fontSize: "13px",
+              lineHeight: "1.5",
+              backgroundColor: "#1e1e1e",
+              color: "#e6e6e6",
+              borderRadius: hasHeader ? "0 0 0.5rem 0.5rem" : "0.5rem",
+              border: "none",
+              padding: "1rem",
+              resize: "none",
+              minHeight: "160px",
+              maxHeight,
+              width: "100%",
+              outline: "none"
+            }
+          }
+        )
+      ) : /* @__PURE__ */ jsxRuntime.jsx(
         "div",
         {
           ref: scrollRef,
@@ -22309,7 +22341,7 @@ var CodeBlock = React125__namespace.default.memo(
       )
     ] });
   },
-  (prev, next) => prev.language === next.language && prev.code === next.code && prev.showCopyButton === next.showCopyButton && prev.maxHeight === next.maxHeight && prev.foldable === next.foldable
+  (prev, next) => prev.language === next.language && prev.code === next.code && prev.showCopyButton === next.showCopyButton && prev.maxHeight === next.maxHeight && prev.foldable === next.foldable && prev.editable === next.editable && prev.onChange === next.onChange
 );
 CodeBlock.displayName = "CodeBlock";
 
@@ -46481,6 +46513,9 @@ function OrbitalProvider({
   );
 }
 OrbitalProvider.displayName = "OrbitalProvider";
+
+// runtime/OrbPreview.tsx
+init_useEventBus();
 function useResolvedSchema(schema, pageName) {
   const [loading, setLoading] = React125.useState(true);
   const [error, setError] = React125.useState(null);
@@ -47250,7 +47285,7 @@ function SlotBridge() {
   }, [slots, render, clear]);
   return null;
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const entityStore = useEntityStore();
@@ -47291,10 +47326,11 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate }) {
     const fallback = setTimeout(() => {
       if (!initSentRef.current) {
         sendEvent("INIT");
+        onLocalFallback?.();
       }
     }, 5e3);
     return () => clearTimeout(fallback);
-  }, [traits2, orbitalNames, sendEvent]);
+  }, [traits2, orbitalNames, sendEvent, onLocalFallback]);
   React125.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -47340,7 +47376,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate }) {
   }, [bridge.connected, orbitalNames, bridge.sendEvent, slotsActions]);
   return null;
 }
-function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
+function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLocalFallback }) {
   const { traits: traits2, allEntities, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React125.useMemo(() => {
     if (pageName && traits2.length > 0) return traits2;
@@ -47380,7 +47416,15 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
     }
   }, [mockKey, serverUrl, mockData, entityStore]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
-    /* @__PURE__ */ jsxRuntime.jsx(TraitInitializer, { traits: allPageTraits, orbitalNames: serverUrl ? orbitalNames : void 0, onNavigate }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      TraitInitializer,
+      {
+        traits: allPageTraits,
+        orbitalNames: serverUrl ? orbitalNames : void 0,
+        onNavigate,
+        onLocalFallback
+      }
+    ),
     /* @__PURE__ */ jsxRuntime.jsx(SlotBridge, {}),
     /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "min-h-full p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) })
   ] }) }) });
@@ -47397,6 +47441,16 @@ function OrbPreview({
   className,
   serverUrl
 }) {
+  const [localFallback, setLocalFallback] = React125.useState(false);
+  const eventBus = useEventBus();
+  const handleLocalFallback = React125.useCallback(() => {
+    if (localFallback) return;
+    setLocalFallback(true);
+    eventBus.emit("UI:NOTIFY", {
+      message: "Preview server unreachable \u2014 running locally without server-side state.",
+      severity: "warning"
+    });
+  }, [localFallback, eventBus]);
   const parseResult = React125.useMemo(() => {
     let parsed;
     if (typeof schema === "string") {
@@ -47454,13 +47508,26 @@ function OrbPreview({
     el.addEventListener("click", handler, true);
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate]);
-  return /* @__PURE__ */ jsxRuntime.jsx(
+  return /* @__PURE__ */ jsxRuntime.jsxs(
     Box,
     {
       ref: containerRef,
       className: `overflow-auto border border-[var(--color-border)] rounded-[var(--radius-md)] ${className ?? ""}`,
       style: { height },
-      children: /* @__PURE__ */ jsxRuntime.jsx(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, children: /* @__PURE__ */ jsxRuntime.jsx(UISlotProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(SchemaRunner, { schema: parsedSchema, serverUrl, mockData: effectiveMockData, pageName: currentPage, onNavigate: handleNavigate }) }) })
+      children: [
+        localFallback && /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "px-3 py-2 bg-[var(--color-warning)] bg-opacity-10 border-b border-[var(--color-warning)] flex items-center gap-2", children: /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "caption", className: "text-[var(--color-warning-foreground)] flex-1", children: "Preview server unreachable \u2014 running locally. Server-side state and persistence are disabled." }) }),
+        /* @__PURE__ */ jsxRuntime.jsx(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, children: /* @__PURE__ */ jsxRuntime.jsx(UISlotProvider, { children: /* @__PURE__ */ jsxRuntime.jsx(
+          SchemaRunner,
+          {
+            schema: parsedSchema,
+            serverUrl,
+            mockData: effectiveMockData,
+            pageName: currentPage,
+            onNavigate: handleNavigate,
+            onLocalFallback: handleLocalFallback
+          }
+        ) }) })
+      ]
     }
   );
 }
@@ -47708,12 +47775,18 @@ var OrbPreviewNodeInner = (props) => {
       el = el.parentElement;
       if (!el || el === contentRef.current) break;
     }
+    const containerNode = {
+      orbitalName: data.orbitalName,
+      traitName: data.traitName,
+      transitionEvent: data.transitionEvent
+    };
     const containerPath = el?.dataset?.patternPath;
     if (!containerPath) {
-      eventBus.emit("UI:PATTERN_INSERT", {
+      eventBus.emit("UI:PATTERN_DROP", {
         parentPath: "root",
         patternType: payload.data.type,
-        index: 0
+        index: 0,
+        containerNode
       });
       return;
     }
@@ -47730,12 +47803,13 @@ var OrbPreviewNodeInner = (props) => {
         break;
       }
     }
-    eventBus.emit("UI:PATTERN_INSERT", {
+    eventBus.emit("UI:PATTERN_DROP", {
       parentPath: containerPath,
       patternType: payload.data.type,
-      index: insertIndex
+      index: insertIndex,
+      containerNode
     });
-  }, [eventBus]);
+  }, [eventBus, data.orbitalName, data.traitName, data.transitionEvent]);
   const handlePreviewDragOver = React125.useCallback((e) => {
     if (!e.dataTransfer.types.includes(ALMADAR_DND_MIME)) return;
     e.preventDefault();
@@ -48338,6 +48412,11 @@ function OrbInspector({ node, schema, editable = false, onSchemaChange, onClose
     ] }),
     /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "flex-1 overflow-y-auto", children: activeTab === "code" ? (
       /* ── Code Tab ── */
+      /* GAP-51: when editable, the CodeBlock molecule renders the existing
+         Textarea atom internally and forwards keystrokes via UI:CODE_CHANGE
+         on the EventBus. The consumer (builder workspace) listens, debounces,
+         parses via safeParseOrbitalSchema, and calls setSchema. Read-only
+         consumers (editable=false) see the existing syntax-highlighted view. */
       /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "p-2", children: /* @__PURE__ */ jsxRuntime.jsx(
         CodeBlock,
         {
@@ -48345,7 +48424,9 @@ function OrbInspector({ node, schema, editable = false, onSchemaChange, onClose
           language: "orb",
           showCopyButton: true,
           showLanguageBadge: true,
-          maxHeight: "100%"
+          maxHeight: "100%",
+          editable,
+          onChange: editable ? (code) => eventBus.emit("UI:CODE_CHANGE", { code }) : void 0
         }
       ) })
     ) : (
@@ -48638,6 +48719,8 @@ function FlowCanvasInner({
   height = 500,
   onNodeClick,
   onLevelChange,
+  onOrbitalDoubleClick,
+  cosmicEntryLevel = "expanded",
   initialOrbital,
   initialLevel,
   initialSelectedNode,
@@ -48711,11 +48794,24 @@ function FlowCanvasInner({
     }
     if (level === "overview") {
       const d = node.data;
-      setExpandedOrbital(d.orbitalName ?? node.id);
+      const orbitalName = d.orbitalName ?? node.id;
+      if (onOrbitalDoubleClick && (cosmicEntryLevel === "overview" || cosmicEntryLevel === "both")) {
+        onOrbitalDoubleClick(orbitalName);
+        return;
+      }
+      setExpandedOrbital(orbitalName);
       setLevel("expanded");
-      onLevelChange?.("expanded", d.orbitalName ?? node.id);
+      onLevelChange?.("expanded", orbitalName);
+      return;
     }
-  }, [level, onLevelChange, atBehaviorLevel, composeLevel]);
+    if (level === "expanded") {
+      const d = node.data;
+      const orbitalName = d.orbitalName ?? node.id;
+      if (orbitalName && onOrbitalDoubleClick && (cosmicEntryLevel === "expanded" || cosmicEntryLevel === "both")) {
+        onOrbitalDoubleClick(orbitalName);
+      }
+    }
+  }, [level, onLevelChange, onOrbitalDoubleClick, cosmicEntryLevel, atBehaviorLevel, composeLevel]);
   const handleNodeClick = React125.useCallback((_, node) => {
     const nodeData = node.data;
     if (level === "expanded") {
@@ -48810,10 +48906,10 @@ function FlowCanvasInner({
   return /* @__PURE__ */ jsxRuntime.jsx(ScreenSizeContext.Provider, { value: screenSize, children: /* @__PURE__ */ jsxRuntime.jsx(PatternSelectionContext.Provider, { value: patternSelectionValue, children: /* @__PURE__ */ jsxRuntime.jsxs(
     Box,
     {
-      className: `flex ${className ?? ""}`,
+      className: `flex h-full ${className ?? ""}`,
       style: { width, height },
       children: [
-        /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative flex-1 min-w-0", children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative flex-1 min-w-0 h-full", children: [
           /* @__PURE__ */ jsxRuntime.jsxs(
             react.ReactFlow,
             {
@@ -48830,6 +48926,7 @@ function FlowCanvasInner({
               minZoom: 0.1,
               maxZoom: 2,
               fitView: true,
+              fitViewOptions: { padding: 0.15 },
               nodesDraggable: true,
               elementsSelectable: true,
               proOptions: { hideAttribution: true },
@@ -49249,7 +49346,11 @@ var AvlOrbitalsCosmicZoom = ({
   color = "var(--color-primary, #4A90D9)",
   animated = true,
   width = "100%",
-  height = 450
+  height = 450,
+  highlightedOrbital,
+  onOrbitalSelect,
+  minZoom = 0.4,
+  maxZoom = 3
 }) => {
   const parsedSchema = React125.useMemo(() => {
     if (typeof schemaProp === "string") return JSON.parse(schemaProp);
@@ -49280,10 +49381,83 @@ var AvlOrbitalsCosmicZoom = ({
   );
   const [selected, setSelected] = React125.useState(null);
   const handleSelect = React125.useCallback(
-    (name) => setSelected((prev) => prev === name ? null : name),
-    []
+    (name) => {
+      setSelected((prev) => prev === name ? null : name);
+      onOrbitalSelect?.(name);
+    },
+    [onOrbitalSelect]
   );
   const selectedView = orbitalViews.find((o) => o.name === selected);
+  const [zoom, setZoom] = React125.useState(1);
+  const [pan, setPan] = React125.useState({ x: 0, y: 0 });
+  const dragStateRef = React125.useRef(null);
+  const transformWrapperRef = React125.useRef(null);
+  const clampZoom = React125.useCallback(
+    (z) => Math.max(minZoom, Math.min(maxZoom, z)),
+    [minZoom, maxZoom]
+  );
+  const handlePointerDown = React125.useCallback((e) => {
+    if (e.target.closest("[data-orbital-tile]")) return;
+    dragStateRef.current = {
+      startX: e.clientX,
+      startY: e.clientY,
+      panX: pan.x,
+      panY: pan.y
+    };
+    e.target.setPointerCapture(e.pointerId);
+  }, [pan]);
+  const handlePointerMove = React125.useCallback((e) => {
+    const drag = dragStateRef.current;
+    if (!drag) return;
+    setPan({
+      x: drag.panX + (e.clientX - drag.startX),
+      y: drag.panY + (e.clientY - drag.startY)
+    });
+  }, []);
+  const handlePointerUp = React125.useCallback((e) => {
+    if (!dragStateRef.current) return;
+    dragStateRef.current = null;
+    try {
+      e.target.releasePointerCapture(e.pointerId);
+    } catch {
+    }
+  }, []);
+  const panRef = React125.useRef(pan);
+  const zoomRef = React125.useRef(zoom);
+  React125.useEffect(() => {
+    panRef.current = pan;
+  }, [pan]);
+  React125.useEffect(() => {
+    zoomRef.current = zoom;
+  }, [zoom]);
+  React125.useEffect(() => {
+    const wrapper = transformWrapperRef.current;
+    if (!wrapper) return;
+    const wheelListener = (e) => {
+      e.preventDefault();
+      const rect = wrapper.getBoundingClientRect();
+      const cursorX = e.clientX - rect.left;
+      const cursorY = e.clientY - rect.top;
+      const currentZoom = zoomRef.current;
+      const currentPan = panRef.current;
+      const worldX = (cursorX - currentPan.x) / currentZoom;
+      const worldY = (cursorY - currentPan.y) / currentZoom;
+      const delta = e.deltaY > 0 ? -0.1 : 0.1;
+      const nextZoom = clampZoom(currentZoom * (1 + delta));
+      const nextPanX = cursorX - worldX * nextZoom;
+      const nextPanY = cursorY - worldY * nextZoom;
+      setZoom(nextZoom);
+      setPan({ x: nextPanX, y: nextPanY });
+    };
+    wrapper.addEventListener("wheel", wheelListener, { passive: false });
+    return () => wrapper.removeEventListener("wheel", wheelListener);
+  }, [clampZoom]);
+  const zoomIn = React125.useCallback(() => setZoom((z) => clampZoom(z * 1.2)), [clampZoom]);
+  const zoomOut = React125.useCallback(() => setZoom((z) => clampZoom(z / 1.2)), [clampZoom]);
+  const resetZoom = React125.useCallback(() => {
+    setZoom(1);
+    setPan({ x: 0, y: 0 });
+  }, []);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     Box,
     {
@@ -49293,59 +49467,115 @@ var AvlOrbitalsCosmicZoom = ({
       style: { width, height: containerH },
       children: [
         /* @__PURE__ */ jsxRuntime.jsx(
-          EventWireOverlay,
+          "div",
           {
-            orbitalViews,
-            crossLinks,
-            color,
-            animated,
-            containerW,
-            containerH
+            ref: transformWrapperRef,
+            onPointerDown: handlePointerDown,
+            onPointerMove: handlePointerMove,
+            onPointerUp: handlePointerUp,
+            onPointerCancel: handlePointerUp,
+            style: {
+              position: "absolute",
+              inset: 0,
+              overflow: "hidden",
+              cursor: dragStateRef.current ? "grabbing" : "grab",
+              touchAction: "none"
+            },
+            children: /* @__PURE__ */ jsxRuntime.jsxs(
+              "div",
+              {
+                style: {
+                  position: "absolute",
+                  inset: 0,
+                  transform: `translate(${pan.x}px, ${pan.y}px) scale(${zoom})`,
+                  transformOrigin: "0 0"
+                },
+                children: [
+                  /* @__PURE__ */ jsxRuntime.jsx(
+                    EventWireOverlay,
+                    {
+                      orbitalViews,
+                      crossLinks,
+                      color,
+                      animated,
+                      containerW,
+                      containerH
+                    }
+                  ),
+                  orbitalViews.map((view) => {
+                    const isHighlighted = view.name === highlightedOrbital;
+                    return /* @__PURE__ */ jsxRuntime.jsx(
+                      Box,
+                      {
+                        role: "button",
+                        tabIndex: 0,
+                        "data-orbital-tile": "true",
+                        onClick: () => handleSelect(view.name),
+                        onKeyDown: (e) => {
+                          if (e.key === "Enter" || e.key === " ") handleSelect(view.name);
+                        },
+                        "aria-label": `Orbital: ${view.name}${isHighlighted ? " (highlighted)" : ""}`,
+                        position: "absolute",
+                        style: {
+                          left: view.cx - UNIT_DISPLAY_W / 2,
+                          top: view.cy - UNIT_DISPLAY_H / 2,
+                          width: UNIT_DISPLAY_W,
+                          height: UNIT_DISPLAY_H,
+                          cursor: "pointer",
+                          transition: "transform 0.2s ease, filter 0.2s ease, box-shadow 0.3s ease",
+                          transform: selected === view.name ? "scale(1.05)" : "scale(1)",
+                          filter: selected && selected !== view.name ? "opacity(0.5)" : "none",
+                          // GAP-52: persistent highlight ring (independent from user selection)
+                          boxShadow: isHighlighted ? `0 0 0 3px ${color}, 0 0 24px 4px ${color}` : "none",
+                          borderRadius: isHighlighted ? "12px" : void 0,
+                          zIndex: isHighlighted ? 11 : selected === view.name ? 10 : 1
+                        },
+                        children: /* @__PURE__ */ jsxRuntime.jsx(
+                          AvlOrbitalUnit,
+                          {
+                            entityName: view.entityName,
+                            fields: view.fieldCount,
+                            persistence: view.persistence,
+                            traits: view.traits,
+                            pages: view.pages,
+                            color,
+                            animated: animated && (selected === view.name || isHighlighted)
+                          }
+                        )
+                      },
+                      view.name
+                    );
+                  }),
+                  selectedView && /* @__PURE__ */ jsxRuntime.jsx(
+                    InfoPanel,
+                    {
+                      view: selectedView,
+                      crossLinks,
+                      color
+                    }
+                  )
+                ]
+              }
+            )
           }
         ),
-        orbitalViews.map((view) => /* @__PURE__ */ jsxRuntime.jsx(
+        /* @__PURE__ */ jsxRuntime.jsxs(
           Box,
           {
-            role: "button",
-            tabIndex: 0,
-            onClick: () => handleSelect(view.name),
-            onKeyDown: (e) => {
-              if (e.key === "Enter" || e.key === " ") handleSelect(view.name);
-            },
-            "aria-label": `Orbital: ${view.name}`,
             position: "absolute",
             style: {
-              left: view.cx - UNIT_DISPLAY_W / 2,
-              top: view.cy - UNIT_DISPLAY_H / 2,
-              width: UNIT_DISPLAY_W,
-              height: UNIT_DISPLAY_H,
-              cursor: "pointer",
-              transition: "transform 0.2s ease, filter 0.2s ease",
-              transform: selected === view.name ? "scale(1.05)" : "scale(1)",
-              filter: selected && selected !== view.name ? "opacity(0.5)" : "none",
-              zIndex: selected === view.name ? 10 : 1
+              top: 12,
+              right: 12,
+              display: "flex",
+              flexDirection: "column",
+              gap: 4,
+              zIndex: 30
             },
-            children: /* @__PURE__ */ jsxRuntime.jsx(
-              AvlOrbitalUnit,
-              {
-                entityName: view.entityName,
-                fields: view.fieldCount,
-                persistence: view.persistence,
-                traits: view.traits,
-                pages: view.pages,
-                color,
-                animated: animated && selected === view.name
-              }
-            )
-          },
-          view.name
-        )),
-        selectedView && /* @__PURE__ */ jsxRuntime.jsx(
-          InfoPanel,
-          {
-            view: selectedView,
-            crossLinks,
-            color
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "secondary", size: "sm", onClick: zoomIn, title: "Zoom in", action: "COSMIC_ZOOM_IN", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "plus", size: "sm" }) }),
+              /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "secondary", size: "sm", onClick: zoomOut, title: "Zoom out", action: "COSMIC_ZOOM_OUT", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "minus", size: "sm" }) }),
+              /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "secondary", size: "sm", onClick: resetZoom, title: "Reset", action: "COSMIC_ZOOM_RESET", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "maximize", size: "sm" }) })
+            ]
           }
         )
       ]

package/dist/avl/index.d.cts

@@ -1210,6 +1210,30 @@ interface FlowCanvasProps {
         transition?: string;
     }) => void;
     onLevelChange?: (level: ViewLevel, orbital?: string) => void;
+    /**
+     * GAP-52: fired when the user double-clicks an orbital. Consumers (e.g. the
+     * builder workspace) use this as the trigger to enter cosmic mode
+     * (`AvlOrbitalsCosmicZoom`) for the focused orbital.
+     *
+     * The level at which this fires is controlled by `cosmicEntryLevel` (default
+     * `'expanded'`). At `'expanded'` the existing overview→expanded drill is
+     * preserved — the callback fires only on the second double-click. At
+     * `'overview'` the callback fires on the FIRST double-click and the existing
+     * drill is suppressed for that interaction. `'both'` fires at either level.
+     *
+     * The callback runs unconditionally — persona / permission gating is the
+     * consumer's responsibility.
+     */
+    onOrbitalDoubleClick?: (orbital: string) => void;
+    /**
+     * GAP-53: which level the `onOrbitalDoubleClick` callback fires at.
+     * - `'expanded'` (default, non-breaking) — fires only at L2 expanded; the
+     *   first overview double-click still drills overview→expanded.
+     * - `'overview'` — fires at L1 overview on the FIRST double-click. The
+     *   overview→expanded drill is suppressed when the callback is provided.
+     * - `'both'` — fires at either level.
+     */
+    cosmicEntryLevel?: 'expanded' | 'overview' | 'both';
     initialOrbital?: string;
     /** Start at Level 2 (expanded) when initialOrbital is set. Default: 'overview'. */
     initialLevel?: ViewLevel;
@@ -1368,6 +1392,29 @@ interface AvlOrbitalsCosmicZoomProps {
     width?: number | string;
     /** Container height */
     height?: number | string;
+    /**
+     * GAP-52: name of the orbital to highlight with a persistent ring/glow.
+     * Independent from user-driven selection (click). Used by the builder workspace
+     * when entering cosmic mode from a focused orbital — the focused orbital is
+     * highlighted while the user can still click any other orbital to select it.
+     */
+    highlightedOrbital?: string;
+    /**
+     * GAP-55: fired when the user clicks an orbital tile. Consumers (e.g. the
+     * builder workspace) use this as the trigger to drill INTO the clicked
+     * orbital — typically by switching back to the canvas tab and opening the
+     * clicked orbital at L2 expanded. Local `selected` toggle (visual highlight +
+     * info panel) still fires regardless of whether the callback is provided.
+     */
+    onOrbitalSelect?: (orbital: string) => void;
+    /**
+     * GAP-54: minimum zoom factor when scroll-wheel zooming. Default 0.4.
+     */
+    minZoom?: number;
+    /**
+     * GAP-54: maximum zoom factor when scroll-wheel zooming. Default 3.
+     */
+    maxZoom?: number;
 }
 declare const AvlOrbitalsCosmicZoom: React__default.FC<AvlOrbitalsCosmicZoomProps>;