@forgeax/app-shell 0.57.0 → 0.59.0

package/dist/react.d.ts

@@ -269,10 +269,23 @@ interface DragPresenceLifecycleOptions {
     readonly target?: DragPresenceEventTarget;
     readonly isStartTarget: (target: EventTarget | null) => boolean;
     readonly onActiveChange: (active: boolean) => void;
+    /** Observes every dragover, including drags that were not admitted as active. */
+    readonly onDragOver?: (target: EventTarget | null) => void;
 }
 /** Own one HTML5 drag-presence lease without owning target or presentation policy. */
 declare function installDragPresenceLifecycle(options: DragPresenceLifecycleOptions): () => void;
 
+interface ViewportResizeEventTarget {
+    addEventListener(type: 'resize', listener: EventListener): void;
+    removeEventListener(type: 'resize', listener: EventListener): void;
+}
+interface ViewportResizeObservationOptions {
+    readonly target?: ViewportResizeEventTarget;
+    readonly onResize: () => void;
+}
+/** Observe viewport resize without owning the caller's geometry policy. */
+declare function installViewportResizeObservation(options: ViewportResizeObservationOptions): () => void;
+
 type PanelContentPadding = 'none' | 'sm' | 'md';
 type PanelContentScroll = 'none' | 'auto';
 type PanelContentTone = 'default' | 'surface' | 'tool';
@@ -414,4 +427,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, type BoundedFrameRetryLifecycleOptions, type CoalescedFrameTaskLifecycle, type CoalescedFrameTaskLifecycleOptions, 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 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, 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 TabPinnedStateSource, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, applyAnchoredResizeDelta, beginAnchoredResize, createCoalescedFrameTaskLifecycle, createPersistentSizeStore, hashSlotHue, installBoundedFrameRetryLifecycle, installDragPresenceLifecycle, installOutsideDismissLifecycle, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };
+export { type AnchoredResizeDirection, AnchoredResizeHandle, type AnchoredResizeHandleProps, type AnchoredResizeSession, type BoundedFrameRetryLifecycleOptions, type CoalescedFrameTaskLifecycle, type CoalescedFrameTaskLifecycleOptions, 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 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, 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 TabPinnedStateSource, type ThresholdPointerDragFinishReason, type ThresholdPointerDragSession, type ThresholdPointerDragSessionOptions, type ViewportResizeEventTarget, type ViewportResizeObservationOptions, applyAnchoredResizeDelta, beginAnchoredResize, createCoalescedFrameTaskLifecycle, createPersistentSizeStore, hashSlotHue, installBoundedFrameRetryLifecycle, installDragPresenceLifecycle, installOutsideDismissLifecycle, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, installViewportResizeObservation, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };

package/dist/react.js

@@ -1864,6 +1864,7 @@ function installDragPresenceLifecycle(options) {
   let disposed = false;
   let active = false;
   let startRegistered = false;
+  let overRegistered = false;
   let endRegistered = false;
   let dropRegistered = false;
   const publish = (next) => {
@@ -1889,6 +1890,13 @@ function installDragPresenceLifecycle(options) {
     if (disposed) return;
     publish(false);
   };
+  const onOver = (event) => {
+    if (disposed) return;
+    try {
+      options.onDragOver?.(event.target);
+    } catch {
+    }
+  };
   const remove = (type, listener, registered) => {
     if (!registered) return;
     try {
@@ -1899,6 +1907,8 @@ function installDragPresenceLifecycle(options) {
   try {
     startRegistered = true;
     target.addEventListener("dragstart", onStart, true);
+    overRegistered = true;
+    target.addEventListener("dragover", onOver, true);
     endRegistered = true;
     target.addEventListener("dragend", onEnd, true);
     dropRegistered = true;
@@ -1907,6 +1917,7 @@ function installDragPresenceLifecycle(options) {
     disposed = true;
     remove("drop", onEnd, dropRegistered);
     remove("dragend", onEnd, endRegistered);
+    remove("dragover", onOver, overRegistered);
     remove("dragstart", onStart, startRegistered);
     publish(false);
   }
@@ -1915,11 +1926,50 @@ function installDragPresenceLifecycle(options) {
     disposed = true;
     remove("drop", onEnd, dropRegistered);
     remove("dragend", onEnd, endRegistered);
+    remove("dragover", onOver, overRegistered);
     remove("dragstart", onStart, startRegistered);
     publish(false);
   };
 }
 
+// src/viewport-resize.ts
+function installViewportResizeObservation(options) {
+  const target = options.target ?? (typeof window === "undefined" ? void 0 : window);
+  if (!target) return () => {
+  };
+  let disposed = false;
+  let registered = false;
+  const onResize = () => {
+    if (disposed) return;
+    try {
+      options.onResize();
+    } catch {
+    }
+  };
+  try {
+    registered = true;
+    target.addEventListener("resize", onResize);
+  } catch {
+    disposed = true;
+    if (registered) {
+      try {
+        target.removeEventListener("resize", onResize);
+      } catch {
+      }
+    }
+  }
+  return () => {
+    if (disposed) return;
+    disposed = true;
+    if (registered) {
+      try {
+        target.removeEventListener("resize", onResize);
+      } catch {
+      }
+    }
+  };
+}
+
 // src/panel.tsx
 import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
 function PanelEmptyState({
@@ -2300,6 +2350,7 @@ export {
   installPointerDragSession,
   installPointerReorderSession,
   installThresholdPointerDragSession,
+  installViewportResizeObservation,
   isDismissExemptInteractionTarget,
   isSlotDebugEnabled,
   useDockLayoutControlBinding,

package/package.json

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