@forgeax/app-shell 0.66.0 → 0.67.0

package/dist/{chunk-MYY2LEZI.js → chunk-ZRVT36QD.js}

@@ -264,7 +264,8 @@ function createDockLayoutPersistence(adapter) {
 }
 function installDockLayoutObservation(source, adapter) {
   let active = true;
-  const subscription = source.onDidLayoutChange(() => {
+  let subscription;
+  const onDidLayoutChange = () => {
     if (!active) return;
     let scope;
     try {
@@ -285,12 +286,21 @@ function installDockLayoutObservation(source, adapter) {
       adapter.onCommitted();
     } catch {
     }
-  });
+  };
+  try {
+    subscription = source.onDidLayoutChange(onDidLayoutChange);
+  } catch {
+    active = false;
+    try {
+      subscription?.dispose();
+    } catch {
+    }
+  }
   return () => {
     if (!active) return;
     active = false;
     try {
-      subscription.dispose();
+      subscription?.dispose();
     } catch {
     }
   };

package/dist/dock.js

@@ -28,7 +28,7 @@ import {
   replaceDockReadyAdapters,
   resolveRegion,
   trackDockPanelVisibility
-} from "./chunk-MYY2LEZI.js";
+} from "./chunk-ZRVT36QD.js";
 export {
   DOCK_REGIONS,
   REGIONS,

package/dist/react.d.ts

@@ -286,6 +286,28 @@ interface ViewportResizeObservationOptions {
 /** Observe viewport resize without owning the caller's geometry policy. */
 declare function installViewportResizeObservation(options: ViewportResizeObservationOptions): () => void;
 
+interface ElementResizeObserver {
+    observe(target: Element): void;
+    disconnect(): void;
+}
+interface ElementResizeObservationOptions {
+    /** Read the complete live element set whenever the source changes. */
+    readonly getElements: () => Iterable<Element>;
+    /** Subscribe to element-set replacement. */
+    readonly subscribeElements: (listener: () => void) => () => void;
+    /** Receive size changes without transferring geometry policy. */
+    readonly onResize: () => void;
+    /** Receive element-set changes after the observer has rebound. */
+    readonly onElementsChanged?: () => void;
+    readonly createObserver?: (listener: () => void) => ElementResizeObserver;
+}
+/**
+ * Observe a replaceable set of elements without owning their identity or layout.
+ * The caller supplies the source and effects; App Shell owns observer rebinding,
+ * source subscription balance, stale-listener fencing, and failure isolation.
+ */
+declare function installElementResizeObservation(options: ElementResizeObservationOptions): () => void;
+
 interface CustomEventObservationTarget {
     addEventListener(type: string, listener: EventListener): void;
     removeEventListener(type: string, listener: EventListener): void;
@@ -507,4 +529,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 ActivePanelObservationOptions, type ActivePanelObservationSubscription, type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, type BoundedFrameRetryLifecycleOptions, type CaptureInteractionEventTarget, type CaptureInteractionObservationOptions, type CoalescedFrameTaskLifecycle, type CoalescedFrameTaskLifecycleOptions, type CustomEventObservationOptions, type CustomEventObservationTarget, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, DockTabAction, type DockTabActionProps, DockTabFrame, type DockTabFrameProps, DockTabIcon, type DockTabIconProps, DockTabStatusSummary, type DockTabStatusSummaryItem, type DockTabStatusSummaryProps, type DockTabStatusTone, DockTabTitle, type DockTabTitleProps, type DragPresenceEventTarget, type DragPresenceLifecycleOptions, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type LayoutFromJsonObservationOptions, type LayoutFromJsonObservationSubscription, type LiveTabPlacement, type LiveTabPlacementSource, type LiveTabTitleSource, OWNED_INTERACTION_SURFACE_SELECTOR, type OutsideDismissEventTarget, type OutsideDismissLifecycleOptions, type OutsideDismissReason, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, type PanelMembershipObservationOptions, type PanelMembershipObservationSubscription, PanelSurface, type PanelSurfaceProps, type PersistentSizeStorage, type PersistentSizeStore, type PersistentSizeStoreOptions, type PersistentSizeUpdate, type PointerDragFinishReason, type PointerDragSessionOptions, type PointerReorderFinishReason, type PointerReorderSession, type PointerReorderSessionOptions, type ReplaceableObservationSetLifecycle, type ReplaceableObservationSetOptions, type ReplaceableObservationSubscription, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, type TabCloseInteractions, type TabCloseInteractionsOptions, type TabPinnedStateSource, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, type ViewportResizeEventTarget, type ViewportResizeObservationOptions, type WillDropObservationOptions, type WillDropObservationSubscription, applyAnchoredResizeDelta, beginAnchoredResize, createCoalescedFrameTaskLifecycle, createPersistentSizeStore, createReplaceableObservationSetLifecycle, hashSlotHue, installActivePanelObservation, installBoundedFrameRetryLifecycle, installCaptureInteractionObservation, installCustomEventObservation, installDragPresenceLifecycle, installLayoutFromJsonObservation, installOutsideDismissLifecycle, installPanelMembershipObservation, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, installViewportResizeObservation, installWillDropObservation, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };
+export { type ActivePanelObservationOptions, type ActivePanelObservationSubscription, type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, type BoundedFrameRetryLifecycleOptions, type CaptureInteractionEventTarget, type CaptureInteractionObservationOptions, type CoalescedFrameTaskLifecycle, type CoalescedFrameTaskLifecycleOptions, type CustomEventObservationOptions, type CustomEventObservationTarget, DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type DockLayoutControlBinding, type DockLayoutControlBindingOptions, DockLayoutMenu, type DockLayoutMenuPanel, type DockLayoutMenuProps, DockTabAction, type DockTabActionProps, DockTabFrame, type DockTabFrameProps, DockTabIcon, type DockTabIconProps, DockTabStatusSummary, type DockTabStatusSummaryItem, type DockTabStatusSummaryProps, type DockTabStatusTone, DockTabTitle, type DockTabTitleProps, type DragPresenceEventTarget, type DragPresenceLifecycleOptions, type ElementResizeObservationOptions, type ElementResizeObserver, FloatingMenu, type FloatingMenuAnchor, type FloatingMenuPoint, type FloatingMenuProps, type LayoutFromJsonObservationOptions, type LayoutFromJsonObservationSubscription, type LiveTabPlacement, type LiveTabPlacementSource, type LiveTabTitleSource, OWNED_INTERACTION_SURFACE_SELECTOR, type OutsideDismissEventTarget, type OutsideDismissLifecycleOptions, type OutsideDismissReason, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, type PanelMembershipObservationOptions, type PanelMembershipObservationSubscription, PanelSurface, type PanelSurfaceProps, type PersistentSizeStorage, type PersistentSizeStore, type PersistentSizeStoreOptions, type PersistentSizeUpdate, type PointerDragFinishReason, type PointerDragSessionOptions, type PointerReorderFinishReason, type PointerReorderSession, type PointerReorderSessionOptions, type ReplaceableObservationSetLifecycle, type ReplaceableObservationSetOptions, type ReplaceableObservationSubscription, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, type TabCloseInteractions, type TabCloseInteractionsOptions, type TabPinnedStateSource, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, type ViewportResizeEventTarget, type ViewportResizeObservationOptions, type WillDropObservationOptions, type WillDropObservationSubscription, applyAnchoredResizeDelta, beginAnchoredResize, createCoalescedFrameTaskLifecycle, createPersistentSizeStore, createReplaceableObservationSetLifecycle, hashSlotHue, installActivePanelObservation, installBoundedFrameRetryLifecycle, installCaptureInteractionObservation, installCustomEventObservation, installDragPresenceLifecycle, installElementResizeObservation, installLayoutFromJsonObservation, installOutsideDismissLifecycle, installPanelMembershipObservation, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, installViewportResizeObservation, installWillDropObservation, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };

package/dist/react.js

@@ -1,7 +1,7 @@
 import {
   createDockLayoutPanelControl,
   installDockLayoutControlToggle
-} from "./chunk-MYY2LEZI.js";
+} from "./chunk-ZRVT36QD.js";
 import {
   shouldShowDetachedPlaceholder
 } from "./chunk-QMT4V6XC.js";
@@ -1546,6 +1546,118 @@ function installViewportResizeObservation(options) {
   };
 }
 
+// src/element-resize-observation.ts
+function installElementResizeObservation(options) {
+  const createObserver = options.createObserver ?? (typeof ResizeObserver === "undefined" ? void 0 : (listener) => new ResizeObserver(listener));
+  let active = true;
+  let observer;
+  let unsubscribe;
+  let rebinding = false;
+  let rebindPending = false;
+  let rebindGeneration = 0;
+  const disconnect = () => {
+    try {
+      observer?.disconnect();
+    } catch {
+    }
+  };
+  const observeCurrent = (clearExisting = true) => {
+    if (!active) return false;
+    rebindPending = true;
+    if (rebinding) {
+      rebindGeneration++;
+      return false;
+    }
+    rebinding = true;
+    let clearBeforePass = clearExisting;
+    let committed = false;
+    try {
+      while (active && rebindPending) {
+        rebindPending = false;
+        committed = false;
+        const generation = ++rebindGeneration;
+        if (!observer) {
+          committed = true;
+          continue;
+        }
+        if (clearBeforePass) disconnect();
+        clearBeforePass = true;
+        if (!active || generation !== rebindGeneration || rebindPending) continue;
+        let elements;
+        try {
+          elements = options.getElements();
+        } catch {
+          continue;
+        }
+        if (!active || generation !== rebindGeneration || rebindPending) continue;
+        try {
+          for (const element of elements) {
+            if (!active || generation !== rebindGeneration || rebindPending) break;
+            try {
+              observer.observe(element);
+            } catch {
+            }
+          }
+        } catch {
+        }
+        if (!active || generation !== rebindGeneration || rebindPending) continue;
+        committed = true;
+      }
+    } finally {
+      rebinding = false;
+    }
+    return active && committed && !rebindPending;
+  };
+  const onResize = () => {
+    if (!active) return;
+    try {
+      options.onResize();
+    } catch {
+    }
+  };
+  const onElementsChanged = () => {
+    if (!active) return;
+    if (!observeCurrent()) return;
+    try {
+      options.onElementsChanged?.();
+    } catch {
+    }
+  };
+  if (createObserver) {
+    try {
+      observer = createObserver(onResize);
+    } catch {
+      observer = void 0;
+    }
+  }
+  observeCurrent(false);
+  try {
+    unsubscribe = options.subscribeElements(onElementsChanged);
+    if (typeof unsubscribe !== "function") {
+      throw new TypeError("element source subscription must return a disposer");
+    }
+  } catch {
+    active = false;
+    disconnect();
+    try {
+      unsubscribe?.();
+    } catch {
+    }
+    unsubscribe = void 0;
+  }
+  return () => {
+    if (!active) return;
+    active = false;
+    try {
+      unsubscribe?.();
+    } catch {
+    }
+    unsubscribe = void 0;
+    disconnect();
+    observer = void 0;
+  };
+}
+
 // src/custom-event-observation.ts
 function installCustomEventObservation(options) {
   const target = options.target ?? (typeof window === "undefined" ? void 0 : window);
@@ -2218,6 +2330,7 @@ export {
   installCaptureInteractionObservation,
   installCustomEventObservation,
   installDragPresenceLifecycle,
+  installElementResizeObservation,
   installLayoutFromJsonObservation,
   installOutsideDismissLifecycle,
   installPanelMembershipObservation,

package/package.json

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