@forgeax/app-shell 0.46.0 → 0.47.0

package/dist/react.d.ts

@@ -143,6 +143,17 @@ interface LiveTabTitleSource {
  */
 declare function useLiveTabTitle(source: LiveTabTitleSource): string | undefined;
 
+interface LiveTabPlacement {
+    readonly isEdge: boolean;
+    readonly groupId: string;
+}
+interface LiveTabPlacementSource {
+    getPlacement(): LiveTabPlacement;
+    subscribe(listener: () => void): () => void;
+}
+/** Observe one tab's live edge/group placement without owning host identities. */
+declare function useLiveTabPlacement(source: LiveTabPlacementSource): LiveTabPlacement | undefined;
+
 type PanelContentPadding = 'none' | 'sm' | 'md';
 type PanelContentScroll = 'none' | 'auto';
 type PanelContentTone = 'default' | 'surface' | 'tool';
@@ -284,4 +295,4 @@ interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
 /** Structural shell marker that preserves the caller's semantic element. */
 declare function ShellSlot({ as, name, ...props }: ShellSlotProps): ReactElement;
 
-export { type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type LiveTabTitleSource, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, PanelSurface, type PanelSurfaceProps, type PersistentSizeStorage, type PersistentSizeStore, type PersistentSizeStoreOptions, type PersistentSizeUpdate, type PointerDragFinishReason, type PointerDragSessionOptions, type PointerReorderFinishReason, type PointerReorderSession, type PointerReorderSessionOptions, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, type TabCloseInteractions, type TabCloseInteractionsOptions, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, applyAnchoredResizeDelta, beginAnchoredResize, createPersistentSizeStore, hashSlotHue, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions };
+export { type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type LiveTabPlacement, type LiveTabPlacementSource, type LiveTabTitleSource, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, PanelSurface, type PanelSurfaceProps, type PersistentSizeStorage, type PersistentSizeStore, type PersistentSizeStoreOptions, type PersistentSizeUpdate, type PointerDragFinishReason, type PointerDragSessionOptions, type PointerReorderFinishReason, type PointerReorderSession, type PointerReorderSessionOptions, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, type TabCloseInteractions, type TabCloseInteractionsOptions, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, applyAnchoredResizeDelta, beginAnchoredResize, createPersistentSizeStore, hashSlotHue, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions };

package/dist/react.js

@@ -1302,6 +1302,76 @@ function useLiveTabTitle(source) {
   );
 }
 
+// src/tab-placement.tsx
+import { useMemo as useMemo2, useSyncExternalStore as useSyncExternalStore3 } from "react";
+function samePlacement(left, right) {
+  return left?.isEdge === right?.isEdge && left?.groupId === right?.groupId;
+}
+function stabilizeLiveTabPlacementSource(source) {
+  let snapshot;
+  try {
+    const initial = source.getPlacement();
+    snapshot = Object.freeze({ isEdge: initial.isEdge, groupId: initial.groupId });
+  } catch {
+    snapshot = void 0;
+  }
+  const synchronize = () => {
+    let next;
+    try {
+      next = source.getPlacement();
+    } catch {
+      return false;
+    }
+    if (samePlacement(snapshot, next)) return false;
+    snapshot = Object.freeze({ isEdge: next.isEdge, groupId: next.groupId });
+    return true;
+  };
+  return {
+    getSnapshot: () => {
+      synchronize();
+      return snapshot;
+    },
+    subscribe: (listener) => {
+      let active = true;
+      const notify = () => {
+        if (!active || !synchronize()) return;
+        try {
+          listener();
+        } catch {
+        }
+      };
+      let dispose = () => {
+      };
+      try {
+        dispose = source.subscribe(notify);
+      } catch {
+        notify();
+        return () => {
+          if (!active) return;
+          active = false;
+        };
+      }
+      notify();
+      return () => {
+        if (!active) return;
+        active = false;
+        try {
+          dispose();
+        } catch {
+        }
+      };
+    }
+  };
+}
+function useLiveTabPlacement(source) {
+  const stable = useMemo2(() => stabilizeLiveTabPlacementSource(source), [source]);
+  return useSyncExternalStore3(
+    stable.subscribe,
+    stable.getSnapshot,
+    stable.getSnapshot
+  );
+}
+
 // src/panel.tsx
 import { jsx as jsx3, jsxs } from "react/jsx-runtime";
 function PanelEmptyState({
@@ -1444,7 +1514,7 @@ var SurfaceRegion = forwardRef(
 );
 
 // src/dock-layout-control.ts
-import { useEffect as useEffect4, useMemo as useMemo2, useSyncExternalStore as useSyncExternalStore3 } from "react";
+import { useEffect as useEffect4, useMemo as useMemo3, useSyncExternalStore as useSyncExternalStore4 } from "react";
 function useDockLayoutControlBinding({
   state,
   onToggle,
@@ -1452,18 +1522,18 @@ function useDockLayoutControlBinding({
   closePanel,
   reopenPanel
 }) {
-  const snapshot = useSyncExternalStore3(
+  const snapshot = useSyncExternalStore4(
     state.subscribe,
     state.getSnapshot,
     state.getSnapshot
   );
   useEffect4(() => installDockLayoutControlToggle({ onToggle }, state), [onToggle, state]);
-  const panelControl = useMemo2(() => createDockLayoutPanelControl({
+  const panelControl = useMemo3(() => createDockLayoutPanelControl({
     isOpen: isPanelOpen,
     close: closePanel,
     reopen: reopenPanel
   }), [closePanel, isPanelOpen, reopenPanel]);
-  return useMemo2(() => ({ snapshot, panelControl }), [panelControl, snapshot]);
+  return useMemo3(() => ({ snapshot, panelControl }), [panelControl, snapshot]);
 }
 
 // src/floating-menu.tsx
@@ -1674,6 +1744,7 @@ export {
   installThresholdPointerDragSession,
   isSlotDebugEnabled,
   useDockLayoutControlBinding,
+  useLiveTabPlacement,
   useLiveTabTitle,
   useLocalSize,
   usePersistentSizeStore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/app-shell",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "Generic Dock, Panel, Window, and Slot composition primitives",
   "license": "Apache-2.0",
   "type": "module",