@forgeax/app-shell 0.61.0 → 0.63.0

package/dist/react.d.ts

@@ -310,6 +310,32 @@ interface CaptureInteractionObservationOptions {
 /** Observe pointerdown and click in capture order without owning interaction policy. */
 declare function installCaptureInteractionObservation(options: CaptureInteractionObservationOptions): () => void;
 
+interface ReplaceableObservationSubscription {
+    dispose(): void;
+}
+interface ReplaceableObservationSetOptions<Item, Observation> {
+    readonly subscribe: (item: Item, listener: (observation: Observation) => void) => ReplaceableObservationSubscription;
+    readonly onObservation: (item: Item, observation: Observation) => void;
+}
+interface ReplaceableObservationSetLifecycle<Item> {
+    replace(items: readonly Item[]): void;
+    dispose(): void;
+}
+/** Own a replaceable set of subscriptions without owning item or event policy. */
+declare function createReplaceableObservationSetLifecycle<Item, Observation>(options: ReplaceableObservationSetOptions<Item, Observation>): ReplaceableObservationSetLifecycle<Item>;
+
+interface PanelMembershipObservationSubscription {
+    dispose(): void;
+}
+interface PanelMembershipObservationOptions<AddEvent = unknown, RemoveEvent = unknown> {
+    readonly subscribeAdd: (listener: (event: AddEvent) => void) => PanelMembershipObservationSubscription;
+    readonly subscribeRemove: (listener: (event: RemoveEvent) => void) => PanelMembershipObservationSubscription;
+    readonly onAdd: (event: AddEvent) => void;
+    readonly onRemove: (event: RemoveEvent) => void;
+}
+/** Observe panel membership changes without owning panel or layout policy. */
+declare function installPanelMembershipObservation<AddEvent, RemoveEvent>(options: PanelMembershipObservationOptions<AddEvent, RemoveEvent>): () => void;
+
 type PanelContentPadding = 'none' | 'sm' | 'md';
 type PanelContentScroll = 'none' | 'auto';
 type PanelContentTone = 'default' | 'surface' | 'tool';
@@ -451,4 +477,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 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 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, installCaptureInteractionObservation, installCustomEventObservation, installDragPresenceLifecycle, installOutsideDismissLifecycle, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, installViewportResizeObservation, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };
+export { 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 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, applyAnchoredResizeDelta, beginAnchoredResize, createCoalescedFrameTaskLifecycle, createPersistentSizeStore, createReplaceableObservationSetLifecycle, hashSlotHue, installBoundedFrameRetryLifecycle, installCaptureInteractionObservation, installCustomEventObservation, installDragPresenceLifecycle, installOutsideDismissLifecycle, installPanelMembershipObservation, installPointerDragSession, installPointerReorderSession, installThresholdPointerDragSession, installViewportResizeObservation, isDismissExemptInteractionTarget, isSlotDebugEnabled, useDockLayoutControlBinding, useLiveTabPlacement, useLiveTabTitle, useLocalSize, usePersistentSizeStore, useTabCloseInteractions, useTabPinnedState };

package/dist/react.js

@@ -2055,6 +2055,120 @@ function installCaptureInteractionObservation(options) {
   };
 }
 
+// src/replaceable-observation-set.ts
+function createReplaceableObservationSetLifecycle(options) {
+  let disposed = false;
+  let generation = 0;
+  let subscriptions = [];
+  const cleanup = (owned) => {
+    for (let index = owned.length - 1; index >= 0; index--) {
+      try {
+        owned[index]?.dispose();
+      } catch {
+      }
+    }
+  };
+  const replace = (items) => {
+    if (disposed) return;
+    const nextGeneration = ++generation;
+    const previous = subscriptions;
+    subscriptions = [];
+    cleanup(previous);
+    if (disposed || generation !== nextGeneration) return;
+    const next = [];
+    for (const item of items) {
+      if (disposed || generation !== nextGeneration) break;
+      let listenerCurrent = true;
+      const listener = (observation) => {
+        if (!listenerCurrent || disposed || generation !== nextGeneration) return;
+        try {
+          options.onObservation(item, observation);
+        } catch {
+        }
+      };
+      try {
+        const subscription = options.subscribe(item, listener);
+        if (!subscription || typeof subscription.dispose !== "function") {
+          throw new TypeError("observation subscription must provide dispose()");
+        }
+        if (disposed || generation !== nextGeneration) {
+          listenerCurrent = false;
+          try {
+            subscription.dispose();
+          } catch {
+          }
+          cleanup(next);
+          return;
+        }
+        next.push(subscription);
+      } catch {
+        listenerCurrent = false;
+        if (generation === nextGeneration) generation++;
+        cleanup(next);
+        return;
+      }
+    }
+    if (disposed || generation !== nextGeneration) {
+      cleanup(next);
+      return;
+    }
+    subscriptions = next;
+  };
+  return {
+    replace,
+    dispose: () => {
+      if (disposed) return;
+      disposed = true;
+      generation++;
+      const owned = subscriptions;
+      subscriptions = [];
+      cleanup(owned);
+    }
+  };
+}
+
+// src/panel-membership-observation.ts
+function installPanelMembershipObservation(options) {
+  let live = true;
+  let addSubscription;
+  let removeSubscription;
+  const onAdd = (event) => {
+    if (!live) return;
+    try {
+      options.onAdd(event);
+    } catch {
+    }
+  };
+  const onRemove = (event) => {
+    if (!live) return;
+    try {
+      options.onRemove(event);
+    } catch {
+    }
+  };
+  const disposeOne = (subscription) => {
+    if (!subscription) return;
+    try {
+      subscription.dispose();
+    } catch {
+    }
+  };
+  try {
+    addSubscription = options.subscribeAdd(onAdd);
+    removeSubscription = options.subscribeRemove(onRemove);
+  } catch {
+    live = false;
+    disposeOne(removeSubscription);
+    disposeOne(addSubscription);
+  }
+  return () => {
+    if (!live) return;
+    live = false;
+    disposeOne(removeSubscription);
+    disposeOne(addSubscription);
+  };
+}
+
 // src/panel.tsx
 import { jsx as jsx5, jsxs as jsxs3 } from "react/jsx-runtime";
 function PanelEmptyState({
@@ -2428,12 +2542,14 @@ export {
   beginAnchoredResize,
   createCoalescedFrameTaskLifecycle,
   createPersistentSizeStore,
+  createReplaceableObservationSetLifecycle,
   hashSlotHue,
   installBoundedFrameRetryLifecycle,
   installCaptureInteractionObservation,
   installCustomEventObservation,
   installDragPresenceLifecycle,
   installOutsideDismissLifecycle,
+  installPanelMembershipObservation,
   installPointerDragSession,
   installPointerReorderSession,
   installThresholdPointerDragSession,

package/package.json

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