@forgeax/app-shell 0.11.1 → 0.13.0

package/dist/window.d.ts

@@ -19,6 +19,64 @@ 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 handle implemented by event-driven native window adapters. */
+interface ExternalWindowHandle {
+    show(): void | Promise<void>;
+    focus(): void | Promise<void>;
+    close(): void | Promise<void>;
+}
+interface ExternalWindowLifecycle {
+    created(): void;
+    error(): void;
+    destroyed(): void;
+}
+/** Adapter seam: products retain native API loading and concrete create policy. */
+interface ExternalWindowHost {
+    getByLabel(label: string): Promise<ExternalWindowHandle | null>;
+    create(label: string, surface: SurfaceDescriptor, options: DetachWindowOptions | undefined, lifecycle: ExternalWindowLifecycle): Promise<ExternalWindowHandle>;
+}
+interface CreateExternalWindowManagerOptions {
+    readonly canDetach: () => boolean;
+    readonly loadHost: () => Promise<ExternalWindowHost | undefined>;
+    readonly createdTimeoutMs?: number;
+}
+/** Product-neutral browser popup carrier with injected surface URL policy. */
+declare function createBrowserWindowManager(options: CreateBrowserWindowManagerOptions): WindowManager;
+/** Event-driven external-window lifecycle with all native policy injected. */
+declare function createExternalWindowManager(options: CreateExternalWindowManagerOptions): 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 +86,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 CreateExternalWindowManagerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type WindowManager, createBrowserWindowManager, createExternalWindowManager, decodeSurfaceFromLocation, encodeSurfaceQuery, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -1,4 +1,144 @@
 // 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 createExternalWindowManager(options) {
+  const closeListeners = /* @__PURE__ */ new Set();
+  const notifyClosed = (surface) => {
+    for (const listener of closeListeners) {
+      try {
+        listener(surface);
+      } catch {
+      }
+    }
+  };
+  return {
+    canDetach: options.canDetach,
+    async openSurfaceWindow(surface, detachOptions) {
+      const host = await options.loadHost();
+      if (!host) return false;
+      const label = surfaceWindowLabel(surface);
+      const existing = await host.getByLabel(label);
+      if (existing) {
+        try {
+          await existing.show();
+          await existing.focus();
+          return true;
+        } catch {
+        }
+      }
+      return new Promise((resolve) => {
+        let settled = false;
+        const finish = (result) => {
+          if (settled) return;
+          settled = true;
+          clearTimeout(timeout);
+          resolve(result);
+        };
+        const timeout = setTimeout(() => finish(true), options.createdTimeoutMs ?? 2e3);
+        void host.create(label, surface, detachOptions, {
+          created: () => finish(true),
+          error: () => finish(false),
+          destroyed: () => notifyClosed(surface)
+        }).catch(() => finish(false));
+      });
+    },
+    async closeSurfaceWindow(surface) {
+      const host = await options.loadHost();
+      if (!host) return;
+      const existing = await host.getByLabel(surfaceWindowLabel(surface));
+      if (!existing) return;
+      try {
+        await existing.close();
+      } catch {
+      }
+    },
+    async isSurfaceWindowOpen(surface) {
+      const host = await options.loadHost();
+      if (!host) return false;
+      return await host.getByLabel(surfaceWindowLabel(surface)) !== null;
+    },
+    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 +188,8 @@ function decodeSurfaceFromLocation(search = typeof window !== "undefined" ? wind
   };
 }
 export {
+  createBrowserWindowManager,
+  createExternalWindowManager,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   surfaceKey,

package/package.json

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