@forgeax/app-shell 0.11.1 → 0.12.0

package/dist/window.d.ts

@@ -19,6 +19,41 @@ interface DetachedWindowTarget {
 interface DetachedWindowCapability<Context = void> {
     createTarget(context: Context): DetachedWindowTarget;
 }
+interface DetachWindowOptions {
+    readonly title?: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly x?: number;
+    readonly y?: number;
+}
+interface WindowManager {
+    canDetach(): boolean;
+    openSurfaceWindow(surface: SurfaceDescriptor, options?: DetachWindowOptions): Promise<boolean>;
+    closeSurfaceWindow(surface: SurfaceDescriptor): Promise<void>;
+    isSurfaceWindowOpen(surface: SurfaceDescriptor): Promise<boolean>;
+    onSurfaceWindowClosed(listener: (surface: SurfaceDescriptor) => void): () => void;
+}
+interface BrowserPopupWindow {
+    readonly closed: boolean;
+    focus(): void;
+    close(): void;
+}
+interface BrowserWindowHost {
+    readonly screen: {
+        readonly width: number;
+        readonly height: number;
+    };
+    open(url: string, target: string, features: string): BrowserPopupWindow | null;
+    setInterval(callback: () => void, delayMs: number): unknown;
+    clearInterval(handle: unknown): void;
+}
+interface CreateBrowserWindowManagerOptions {
+    readonly surfaceUrl: (surface: SurfaceDescriptor) => string;
+    readonly host?: BrowserWindowHost;
+    readonly closePollIntervalMs?: number;
+}
+/** Product-neutral browser popup carrier with injected surface URL policy. */
+declare function createBrowserWindowManager(options: CreateBrowserWindowManagerOptions): WindowManager;
 /** Stable identity shared by keep-alive registries and physical carriers. */
 declare function surfaceKey(surface: SurfaceDescriptor): string;
 /** Deterministic, injective and carrier-safe label for the complete identity. */
@@ -28,4 +63,4 @@ declare function encodeSurfaceQuery(surface: SurfaceDescriptor): string;
 /** Decode structural identity, or null for a normal shell/invalid entry. */
 declare function decodeSurfaceFromLocation(search?: string): SurfaceDescriptor | null;
 
-export { type DetachedWindowCapability, type DetachedWindowTarget, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, decodeSurfaceFromLocation, encodeSurfaceQuery, surfaceKey, surfaceWindowLabel };
+export { type BrowserPopupWindow, type BrowserWindowHost, type CreateBrowserWindowManagerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type WindowManager, createBrowserWindowManager, decodeSurfaceFromLocation, encodeSurfaceQuery, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -1,4 +1,80 @@
 // src/window.ts
+function currentBrowserHost() {
+  if (typeof window === "undefined" || typeof window.open !== "function") return void 0;
+  return {
+    screen: window.screen,
+    open: (url, target, features) => window.open(url, target, features),
+    setInterval: (callback, delayMs) => window.setInterval(callback, delayMs),
+    clearInterval: (handle) => window.clearInterval(handle)
+  };
+}
+function createBrowserWindowManager(options) {
+  const host = options.host ?? currentBrowserHost();
+  const windows = /* @__PURE__ */ new Map();
+  const closePolls = /* @__PURE__ */ new Map();
+  const closeListeners = /* @__PURE__ */ new Set();
+  const forget = (surface) => {
+    const key = surfaceWindowLabel(surface);
+    const poll = closePolls.get(key);
+    if (poll !== void 0) host?.clearInterval(poll);
+    closePolls.delete(key);
+    windows.delete(key);
+  };
+  const notifyClosed = (surface) => {
+    for (const listener of closeListeners) {
+      try {
+        listener(surface);
+      } catch {
+      }
+    }
+  };
+  return {
+    canDetach: () => host !== void 0,
+    async openSurfaceWindow(surface, detachOptions) {
+      if (!host) return false;
+      const label = surfaceWindowLabel(surface);
+      const existing = windows.get(label);
+      if (existing !== void 0 && !existing.closed) {
+        existing.focus();
+        return true;
+      }
+      if (existing !== void 0) forget(surface);
+      const width = detachOptions?.width ?? 960;
+      const height = detachOptions?.height ?? 720;
+      const left = detachOptions?.x ?? Math.max(0, Math.round((host.screen.width - width) / 2));
+      const top = detachOptions?.y ?? Math.max(0, Math.round((host.screen.height - height) / 2));
+      const popup = host.open(
+        options.surfaceUrl(surface),
+        label,
+        `popup=yes,width=${width},height=${height},left=${left},top=${top},resizable=yes`
+      );
+      if (popup === null) return false;
+      windows.set(label, popup);
+      const poll = host.setInterval(() => {
+        if (!popup.closed) return;
+        forget(surface);
+        notifyClosed(surface);
+      }, options.closePollIntervalMs ?? 250);
+      closePolls.set(label, poll);
+      return true;
+    },
+    async closeSurfaceWindow(surface) {
+      const popup = windows.get(surfaceWindowLabel(surface));
+      if (popup !== void 0 && !popup.closed) popup.close();
+      forget(surface);
+    },
+    async isSurfaceWindowOpen(surface) {
+      const popup = windows.get(surfaceWindowLabel(surface));
+      return popup !== void 0 && !popup.closed;
+    },
+    onSurfaceWindowClosed(listener) {
+      closeListeners.add(listener);
+      return () => {
+        closeListeners.delete(listener);
+      };
+    }
+  };
+}
 function surfaceKey(surface) {
   const id = surface.id.includes(":") || surface.id.startsWith("~") ? `~${encodeURIComponent(surface.id)}` : surface.id;
   const pane = surface.pane ? `:${surface.pane}` : "";
@@ -48,6 +124,7 @@ function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? wind
   };
 }
 export {
+  createBrowserWindowManager,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   surfaceKey,

package/package.json

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