@ai-matrx/summon 0.1.3 → 0.1.5

package/dist/window.d.cts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import react__default, { ComponentType, SVGAttributes, ReactNode } from 'react';
 import { WindowRect, WindowPersistenceRegistration, MobilePresentation } from '@ai-matrx/summon';
 import { TraySnapshotCapture } from '@ai-matrx/summon/window-host';
-export { DEFAULT_ESCAPE_YIELD_SELECTOR, DEFAULT_MOBILE_TOP_OFFSET, DEFAULT_WINDOW_CONFIG, TrayPreviewContext, TrayPreviewEntry, TraySnapshotCapture, WindowConfig, WindowSelectionSurface, WindowSelectionSurfaceProps, WindowTraySync, WindowsProvider, WindowsProviderProps, getTrayPreviewEntry, registerTrayPreview, resetTrayPreviews, useWindowConfig } from '@ai-matrx/summon/window-host';
+export { DEFAULT_ESCAPE_YIELD_SELECTOR, DEFAULT_MOBILE_TOP_OFFSET, DEFAULT_WINDOW_CONFIG, PopoutContext, PopoutContextValue, PopoutMode, TrayPreviewContext, TrayPreviewEntry, TraySnapshotCapture, WindowConfig, WindowSelectionSurface, WindowSelectionSurfaceProps, WindowTraySync, WindowsProvider, WindowsProviderProps, getTrayPreviewEntry, registerTrayPreview, resetTrayPreviews, useOverlaySurfaceRenderAck, usePopout, usePopoutContainer, useWindowConfig } from '@ai-matrx/summon/window-host';
 
 type ResizeEdge = "e" | "s" | "se" | "w" | "sw" | "n" | "ne" | "nw";
 /** Where to place the window when it first opens. */
@@ -300,16 +300,6 @@ declare function LayoutIconButton({ onClick, type, className, }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
-/**
- * Acknowledge a visible presentation that intentionally replaces WindowPanel.
- *
- * Registered singleton window overlays normally prove they are on screen by mounting a
- * WindowPanel and registering geometry. Mobile drawers, sheets, and full-screen
- * viewers have no window-manager geometry, so their composition root must use
- * this hook while that alternate surface is active.
- */
-declare function useOverlaySurfaceRenderAck(overlayId: string, active: boolean): void;
-
 /** Store a local snapshot blob for a window and notify subscribers. */
 declare function setTraySnapshot(id: string, blob: Blob): void;
 /** Clear the snapshot for a given window id. */
@@ -399,40 +389,6 @@ interface TrayStatusChipProps {
 }
 declare function TrayStatusChip({ icon: Icon, tone, count, caption, segments, pulse, }: TrayStatusChipProps): react.JSX.Element;
 
-type PopoutMode = "pip" | "popup";
-interface PopoutContextValue {
-    /**
-     * The popout `Document`. `null` when this subtree is rendered in the
-     * parent (the default).
-     */
-    popoutDocument: Document | null;
-    /**
-     * The popout `Window`. `null` when this subtree is rendered in the parent.
-     * Use for `addEventListener`, `matchMedia`, `innerWidth`, etc., when the
-     * popout-scoped answer is what you need.
-     */
-    popoutWindow: Window | null;
-    /**
-     * Element to use as the Radix `Portal.container` prop so floating UI
-     * (tooltips, popovers, dropdowns) renders inside the popout instead of
-     * the parent `document.body`. Returns `null` outside a popout —
-     * `usePopoutContainer` coerces this to `undefined` so Radix falls back
-     * to its default container automatically.
-     */
-    popoutContainer: HTMLElement | null;
-    /**
-     * Which popout mechanism is in use. `null` outside a popout.
-     * Currently only used for diagnostics; downstream components may branch
-     * on it later (e.g. show different chrome for `popup` vs `pip`).
-     */
-    mode: PopoutMode | null;
-}
-declare const PopoutContext: react.Context<PopoutContextValue>;
-/** Read the current popout context. Always defined — never throws. */
-declare function usePopout(): PopoutContextValue;
-
-declare function usePopoutContainer(): HTMLElement | undefined;
-
 interface OpenPopoutOptions {
     width: number;
     height: number;
@@ -793,4 +749,4 @@ declare function assertLazyLoaded(moduleId: string, report?: (message: string, s
 
 declare function sanitizeWindowData(value: unknown, allowedKeys: readonly string[]): Record<string, unknown>;
 
-export { AUTO_OPEN_MIN_WIDTH, AUTO_OPEN_NO_ROOM_EVENT, type AutoOpenPlacement, DEFAULT_DRAG_OUT_CONFIG, type DragOutConfig, type DragOutEvalResult, type DragOutInput, type DragOutState, type ElementThumbnailOptions, INITIAL_DRAG_OUT_STATE, LayoutIcon, LayoutIconButton, type LayoutIconType, MOBILE_WINDOW_TITLE_TEXT, MinimizedWindowContent, MobileCardSurface, MobileDrawerSurface, MobileWindowActionsRow, MobileWindowTitle, MobileWindowTitleRow, type OpenPopoutOptions, type OpenPopoutResult, type PopOutByIdOptions, type PopoutCapability, PopoutContext, type PopoutContextValue, type PopoutControlApi, type PopoutMode, type ResizeEdge, TrayChipPreview, TrayStatusChip, type TrayStatusChipProps, type TrayStatusSegment, type TrayStatusTone, type UnbiddenRaiseVerdict, type UnbiddenRefusalCode, type UsePopoutWindowReturn, type UseWindowPanelOptions, type UseWindowPanelReturn, WindowPanel, type WindowPanelBaseProps, type WindowPanelCloseBinding, type WindowPanelProps, type WindowPosition, WindowSidebar, type WindowSidebarItem, assertLazyLoaded, autoOpenHasRoom, buildPopoutOpts, captureElementThumbnail, clearAllPopoutPending, clearAutoOpened, clearTraySnapshot, defaultTraySnapshotCapture, detectPopoutCapability, evaluateDragOut, forEachPopoutWindow, getPendingPopoutWindowIds, getPopoutOpener, getPopoutWindow, getTraySnapshot, isAutoOpened, isUnderRoute, markAutoOpened, mayRaiseUnbidden, measureWorkingColumn, mobileWindowTitleClass, resetDefaultWindowCascade, resolveAutoOpenPlacement, resolvePosition, sanitizeWindowData, setTraySnapshot, subscribePopoutWindowMap, subscribeTraySnapshotMap, supportsAnyPopout, supportsDocumentPictureInPicture, useOverlaySurfaceRenderAck, usePopout, usePopoutContainer, usePopoutControl, usePopoutWindow, usePopoutWindowRef, useWindowPanel };
+export { AUTO_OPEN_MIN_WIDTH, AUTO_OPEN_NO_ROOM_EVENT, type AutoOpenPlacement, DEFAULT_DRAG_OUT_CONFIG, type DragOutConfig, type DragOutEvalResult, type DragOutInput, type DragOutState, type ElementThumbnailOptions, INITIAL_DRAG_OUT_STATE, LayoutIcon, LayoutIconButton, type LayoutIconType, MOBILE_WINDOW_TITLE_TEXT, MinimizedWindowContent, MobileCardSurface, MobileDrawerSurface, MobileWindowActionsRow, MobileWindowTitle, MobileWindowTitleRow, type OpenPopoutOptions, type OpenPopoutResult, type PopOutByIdOptions, type PopoutCapability, type PopoutControlApi, type ResizeEdge, TrayChipPreview, TrayStatusChip, type TrayStatusChipProps, type TrayStatusSegment, type TrayStatusTone, type UnbiddenRaiseVerdict, type UnbiddenRefusalCode, type UsePopoutWindowReturn, type UseWindowPanelOptions, type UseWindowPanelReturn, WindowPanel, type WindowPanelBaseProps, type WindowPanelCloseBinding, type WindowPanelProps, type WindowPosition, WindowSidebar, type WindowSidebarItem, assertLazyLoaded, autoOpenHasRoom, buildPopoutOpts, captureElementThumbnail, clearAllPopoutPending, clearAutoOpened, clearTraySnapshot, defaultTraySnapshotCapture, detectPopoutCapability, evaluateDragOut, forEachPopoutWindow, getPendingPopoutWindowIds, getPopoutOpener, getPopoutWindow, getTraySnapshot, isAutoOpened, isUnderRoute, markAutoOpened, mayRaiseUnbidden, measureWorkingColumn, mobileWindowTitleClass, resetDefaultWindowCascade, resolveAutoOpenPlacement, resolvePosition, sanitizeWindowData, setTraySnapshot, subscribePopoutWindowMap, subscribeTraySnapshotMap, supportsAnyPopout, supportsDocumentPictureInPicture, usePopoutControl, usePopoutWindow, usePopoutWindowRef, useWindowPanel };

package/dist/window.d.ts

@@ -2,7 +2,7 @@ import * as react from 'react';
 import react__default, { ComponentType, SVGAttributes, ReactNode } from 'react';
 import { WindowRect, WindowPersistenceRegistration, MobilePresentation } from '@ai-matrx/summon';
 import { TraySnapshotCapture } from '@ai-matrx/summon/window-host';
-export { DEFAULT_ESCAPE_YIELD_SELECTOR, DEFAULT_MOBILE_TOP_OFFSET, DEFAULT_WINDOW_CONFIG, TrayPreviewContext, TrayPreviewEntry, TraySnapshotCapture, WindowConfig, WindowSelectionSurface, WindowSelectionSurfaceProps, WindowTraySync, WindowsProvider, WindowsProviderProps, getTrayPreviewEntry, registerTrayPreview, resetTrayPreviews, useWindowConfig } from '@ai-matrx/summon/window-host';
+export { DEFAULT_ESCAPE_YIELD_SELECTOR, DEFAULT_MOBILE_TOP_OFFSET, DEFAULT_WINDOW_CONFIG, PopoutContext, PopoutContextValue, PopoutMode, TrayPreviewContext, TrayPreviewEntry, TraySnapshotCapture, WindowConfig, WindowSelectionSurface, WindowSelectionSurfaceProps, WindowTraySync, WindowsProvider, WindowsProviderProps, getTrayPreviewEntry, registerTrayPreview, resetTrayPreviews, useOverlaySurfaceRenderAck, usePopout, usePopoutContainer, useWindowConfig } from '@ai-matrx/summon/window-host';
 
 type ResizeEdge = "e" | "s" | "se" | "w" | "sw" | "n" | "ne" | "nw";
 /** Where to place the window when it first opens. */
@@ -300,16 +300,6 @@ declare function LayoutIconButton({ onClick, type, className, }: {
     className?: string | undefined;
 }): react.JSX.Element;
 
-/**
- * Acknowledge a visible presentation that intentionally replaces WindowPanel.
- *
- * Registered singleton window overlays normally prove they are on screen by mounting a
- * WindowPanel and registering geometry. Mobile drawers, sheets, and full-screen
- * viewers have no window-manager geometry, so their composition root must use
- * this hook while that alternate surface is active.
- */
-declare function useOverlaySurfaceRenderAck(overlayId: string, active: boolean): void;
-
 /** Store a local snapshot blob for a window and notify subscribers. */
 declare function setTraySnapshot(id: string, blob: Blob): void;
 /** Clear the snapshot for a given window id. */
@@ -399,40 +389,6 @@ interface TrayStatusChipProps {
 }
 declare function TrayStatusChip({ icon: Icon, tone, count, caption, segments, pulse, }: TrayStatusChipProps): react.JSX.Element;
 
-type PopoutMode = "pip" | "popup";
-interface PopoutContextValue {
-    /**
-     * The popout `Document`. `null` when this subtree is rendered in the
-     * parent (the default).
-     */
-    popoutDocument: Document | null;
-    /**
-     * The popout `Window`. `null` when this subtree is rendered in the parent.
-     * Use for `addEventListener`, `matchMedia`, `innerWidth`, etc., when the
-     * popout-scoped answer is what you need.
-     */
-    popoutWindow: Window | null;
-    /**
-     * Element to use as the Radix `Portal.container` prop so floating UI
-     * (tooltips, popovers, dropdowns) renders inside the popout instead of
-     * the parent `document.body`. Returns `null` outside a popout —
-     * `usePopoutContainer` coerces this to `undefined` so Radix falls back
-     * to its default container automatically.
-     */
-    popoutContainer: HTMLElement | null;
-    /**
-     * Which popout mechanism is in use. `null` outside a popout.
-     * Currently only used for diagnostics; downstream components may branch
-     * on it later (e.g. show different chrome for `popup` vs `pip`).
-     */
-    mode: PopoutMode | null;
-}
-declare const PopoutContext: react.Context<PopoutContextValue>;
-/** Read the current popout context. Always defined — never throws. */
-declare function usePopout(): PopoutContextValue;
-
-declare function usePopoutContainer(): HTMLElement | undefined;
-
 interface OpenPopoutOptions {
     width: number;
     height: number;
@@ -793,4 +749,4 @@ declare function assertLazyLoaded(moduleId: string, report?: (message: string, s
 
 declare function sanitizeWindowData(value: unknown, allowedKeys: readonly string[]): Record<string, unknown>;
 
-export { AUTO_OPEN_MIN_WIDTH, AUTO_OPEN_NO_ROOM_EVENT, type AutoOpenPlacement, DEFAULT_DRAG_OUT_CONFIG, type DragOutConfig, type DragOutEvalResult, type DragOutInput, type DragOutState, type ElementThumbnailOptions, INITIAL_DRAG_OUT_STATE, LayoutIcon, LayoutIconButton, type LayoutIconType, MOBILE_WINDOW_TITLE_TEXT, MinimizedWindowContent, MobileCardSurface, MobileDrawerSurface, MobileWindowActionsRow, MobileWindowTitle, MobileWindowTitleRow, type OpenPopoutOptions, type OpenPopoutResult, type PopOutByIdOptions, type PopoutCapability, PopoutContext, type PopoutContextValue, type PopoutControlApi, type PopoutMode, type ResizeEdge, TrayChipPreview, TrayStatusChip, type TrayStatusChipProps, type TrayStatusSegment, type TrayStatusTone, type UnbiddenRaiseVerdict, type UnbiddenRefusalCode, type UsePopoutWindowReturn, type UseWindowPanelOptions, type UseWindowPanelReturn, WindowPanel, type WindowPanelBaseProps, type WindowPanelCloseBinding, type WindowPanelProps, type WindowPosition, WindowSidebar, type WindowSidebarItem, assertLazyLoaded, autoOpenHasRoom, buildPopoutOpts, captureElementThumbnail, clearAllPopoutPending, clearAutoOpened, clearTraySnapshot, defaultTraySnapshotCapture, detectPopoutCapability, evaluateDragOut, forEachPopoutWindow, getPendingPopoutWindowIds, getPopoutOpener, getPopoutWindow, getTraySnapshot, isAutoOpened, isUnderRoute, markAutoOpened, mayRaiseUnbidden, measureWorkingColumn, mobileWindowTitleClass, resetDefaultWindowCascade, resolveAutoOpenPlacement, resolvePosition, sanitizeWindowData, setTraySnapshot, subscribePopoutWindowMap, subscribeTraySnapshotMap, supportsAnyPopout, supportsDocumentPictureInPicture, useOverlaySurfaceRenderAck, usePopout, usePopoutContainer, usePopoutControl, usePopoutWindow, usePopoutWindowRef, useWindowPanel };
+export { AUTO_OPEN_MIN_WIDTH, AUTO_OPEN_NO_ROOM_EVENT, type AutoOpenPlacement, DEFAULT_DRAG_OUT_CONFIG, type DragOutConfig, type DragOutEvalResult, type DragOutInput, type DragOutState, type ElementThumbnailOptions, INITIAL_DRAG_OUT_STATE, LayoutIcon, LayoutIconButton, type LayoutIconType, MOBILE_WINDOW_TITLE_TEXT, MinimizedWindowContent, MobileCardSurface, MobileDrawerSurface, MobileWindowActionsRow, MobileWindowTitle, MobileWindowTitleRow, type OpenPopoutOptions, type OpenPopoutResult, type PopOutByIdOptions, type PopoutCapability, type PopoutControlApi, type ResizeEdge, TrayChipPreview, TrayStatusChip, type TrayStatusChipProps, type TrayStatusSegment, type TrayStatusTone, type UnbiddenRaiseVerdict, type UnbiddenRefusalCode, type UsePopoutWindowReturn, type UseWindowPanelOptions, type UseWindowPanelReturn, WindowPanel, type WindowPanelBaseProps, type WindowPanelCloseBinding, type WindowPanelProps, type WindowPosition, WindowSidebar, type WindowSidebarItem, assertLazyLoaded, autoOpenHasRoom, buildPopoutOpts, captureElementThumbnail, clearAllPopoutPending, clearAutoOpened, clearTraySnapshot, defaultTraySnapshotCapture, detectPopoutCapability, evaluateDragOut, forEachPopoutWindow, getPendingPopoutWindowIds, getPopoutOpener, getPopoutWindow, getTraySnapshot, isAutoOpened, isUnderRoute, markAutoOpened, mayRaiseUnbidden, measureWorkingColumn, mobileWindowTitleClass, resetDefaultWindowCascade, resolveAutoOpenPlacement, resolvePosition, sanitizeWindowData, setTraySnapshot, subscribePopoutWindowMap, subscribeTraySnapshotMap, supportsAnyPopout, supportsDocumentPictureInPicture, usePopoutControl, usePopoutWindow, usePopoutWindowRef, useWindowPanel };

package/dist/window.js

@@ -800,7 +800,7 @@ function useDebugFlag(debug) {
 }
 
 // src/window/WindowPanel.tsx
-import { useOverlayLink } from "@ai-matrx/summon/url";
+import { useOverlayLink } from "@ai-matrx/summon/react";
 
 // src/window/utils/urlSyncIdentity.ts
 function resolveWindowUrlSyncKey(registryKey, explicitKey) {
@@ -1849,21 +1849,9 @@ import { selectPopoutMode as selectPopoutMode2 } from "@ai-matrx/summon";
 // src/window/popout/PopoutShell.tsx
 import { useMemo } from "react";
 import { PortalContainerProvider } from "@ai-matrx/design-system";
-
-// src/window/popout/PopoutContext.tsx
-import { createContext, useContext } from "react";
-var DEFAULT_VALUE = {
-  popoutDocument: null,
-  popoutWindow: null,
-  popoutContainer: null,
-  mode: null
-};
-var PopoutContext = createContext(DEFAULT_VALUE);
-function usePopout() {
-  return useContext(PopoutContext);
-}
-
-// src/window/popout/PopoutShell.tsx
+import {
+  PopoutContext
+} from "@ai-matrx/summon/window-host";
 import { jsx as jsx10 } from "react/jsx-runtime";
 function PopoutShell({
   popoutWindow,
@@ -1894,6 +1882,9 @@ function PopoutPortal({ windowId, children }) {
   );
 }
 
+// src/window/WindowPanel.tsx
+import { PopoutContext as PopoutContext2, usePopout } from "@ai-matrx/summon/window-host";
+
 // src/window/tray/traySnapshotMap.ts
 import { globalSlot as globalSlot5 } from "@ai-matrx/kit/global-slot";
 var MAX_SNAPSHOTS = 16;
@@ -2925,7 +2916,7 @@ function WindowPanel({
     }
   ) : null;
   const bodyPortal = isMounted && bodyHost && !isMobile ? createPortal3(
-    /* @__PURE__ */ jsx14(PopoutContext.Provider, { value: bodyPopoutValue, children: /* @__PURE__ */ jsx14(PortalContainerProvider2, { container: bodyPortalContainer, children: /* @__PURE__ */ jsx14("div", { className: "contents", onPointerDown: onFocus, onPointerDownCapture: claimFront, onFocusCapture: claimFront, children: bodyContent }) }) }),
+    /* @__PURE__ */ jsx14(PopoutContext2.Provider, { value: bodyPopoutValue, children: /* @__PURE__ */ jsx14(PortalContainerProvider2, { container: bodyPortalContainer, children: /* @__PURE__ */ jsx14("div", { className: "contents", onPointerDown: onFocus, onPointerDownCapture: claimFront, onFocusCapture: claimFront, children: bodyContent }) }) }),
     bodyHost
   ) : null;
   if (isMobile) {
@@ -3768,18 +3759,8 @@ function WindowSidebar({
   }) }) });
 }
 
-// src/window/useOverlaySurfaceRenderAck.ts
-import { useEffect as useEffect6 } from "react";
-import { ackOverlaySurfaceRender, clearOverlaySurfaceRender } from "@ai-matrx/summon";
-function useOverlaySurfaceRenderAck(overlayId, active) {
-  useEffect6(() => {
-    if (!active) return void 0;
-    ackOverlaySurfaceRender(overlayId);
-    return () => clearOverlaySurfaceRender(overlayId);
-  }, [active, overlayId]);
-}
-
 // src/window.ts
+import { useOverlaySurfaceRenderAck } from "@ai-matrx/summon/window-host";
 import {
   registerTrayPreview,
   getTrayPreviewEntry as getTrayPreviewEntry3,
@@ -3858,10 +3839,9 @@ function TrayStatusChip({
   ] });
 }
 
-// src/window/popout/usePopoutContainer.ts
-function usePopoutContainer() {
-  return usePopout().popoutContainer ?? void 0;
-}
+// src/window.ts
+import { usePopout as usePopout2, PopoutContext as PopoutContext3 } from "@ai-matrx/summon/window-host";
+import { usePopoutContainer } from "@ai-matrx/summon/window-host";
 
 // src/window/utils/mayRaiseUnbidden.ts
 import { getOverlayMeta as getOverlayMeta4 } from "@ai-matrx/summon";
@@ -3954,7 +3934,7 @@ export {
   MobileWindowActionsRow,
   MobileWindowTitle,
   MobileWindowTitleRow,
-  PopoutContext,
+  PopoutContext3 as PopoutContext,
   TrayChipPreview,
   TrayStatusChip,
   WindowPanel,
@@ -3996,7 +3976,7 @@ export {
   supportsAnyPopout,
   supportsDocumentPictureInPicture,
   useOverlaySurfaceRenderAck,
-  usePopout,
+  usePopout2 as usePopout,
   usePopoutContainer,
   usePopoutControl,
   usePopoutWindow,