@forgeax/app-shell 0.20.0 → 0.22.0

package/dist/{chunk-ZYCR2LSP.js → chunk-EEPX63DF.js}

@@ -68,6 +68,62 @@ function createPanelWindowingController() {
     }
   };
 }
+function createSurfaceWindowingController(options) {
+  const emptySnapshot = Object.freeze({});
+  const floating = /* @__PURE__ */ new Set();
+  const listeners = /* @__PURE__ */ new Set();
+  let snapshot = emptySnapshot;
+  const publish = () => {
+    snapshot = floating.size === 0 ? emptySnapshot : Object.freeze(Object.fromEntries([...floating].sort().map((key) => [key, true])));
+    for (const listener of listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
+  };
+  const markFloating = (surface) => {
+    const key = surfaceKey(surface);
+    if (floating.has(key)) return;
+    floating.add(key);
+    publish();
+  };
+  const markDocked = (surface) => {
+    if (!floating.delete(surfaceKey(surface))) return;
+    publish();
+  };
+  return {
+    snapshot: () => snapshot,
+    onChange(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    async detachSurface(surface, detachOptions) {
+      if (!options.manager.canDetach()) return false;
+      try {
+        options.beforeDetach?.(surface);
+      } catch {
+        return false;
+      }
+      markFloating(surface);
+      let opened = false;
+      try {
+        opened = await options.manager.openSurfaceWindow(surface, detachOptions);
+      } catch {
+        opened = false;
+      }
+      if (!opened) markDocked(surface);
+      return opened;
+    },
+    async redockSurface(surface) {
+      await options.manager.closeSurfaceWindow(surface);
+      markDocked(surface);
+    },
+    markSurfaceDocked: markDocked
+  };
+}
 function currentBrowserHost() {
   if (typeof window === "undefined" || typeof window.open !== "function") return void 0;
   return {
@@ -261,6 +317,7 @@ export {
   canOpenPanelWindow,
   shouldShowDetachedPlaceholder,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   createBrowserWindowManager,
   createExternalWindowManager,
   surfaceKey,

package/dist/panel.css

@@ -39,3 +39,28 @@
 .fx-panel-content[data-tone="tool"] {
   background: var(--color-background-base, #191919);
 }
+
+.fx-panel-empty {
+  height: 100%;
+  min-height: 120px;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  gap: 6px;
+  padding: 16px;
+  color: var(--color-text-tertiary, #778);
+  text-align: center;
+}
+
+.fx-panel-empty-title {
+  color: var(--color-text-secondary, #aab);
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.fx-panel-empty-detail {
+  font-family: var(--font-mono, monospace);
+  font-size: 11px;
+  opacity: 0.72;
+}

package/dist/react.d.ts

@@ -37,6 +37,12 @@ interface PanelSurfaceProps extends Omit<HTMLAttributes<HTMLElement>, 'children'
     readonly content?: PanelContentPolicy;
     readonly children?: ReactNode;
 }
+interface PanelEmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'title'> {
+    readonly title: ReactNode;
+    readonly detail?: ReactNode;
+}
+/** Product-neutral empty panel presentation with caller-owned content. */
+declare function PanelEmptyState({ title, detail, className, ...props }: PanelEmptyStateProps): ReactElement;
 /** Product-neutral panel section and content presentation. */
 declare function PanelSurface({ id, registered, singleTab, header, content, children, className, ...props }: PanelSurfaceProps): ReactElement;
 
@@ -92,4 +98,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 { DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelSurface, type PanelSurfaceProps, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, hashSlotHue, isSlotDebugEnabled, useLocalSize };
+export { DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, DetachedSurfaceStatus, type DetachedSurfaceStatusProps, type DetachedSurfaceStatusTone, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelEmptyState, type PanelEmptyStateProps, PanelSurface, type PanelSurfaceProps, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, SurfacePlaceholder, type SurfacePlaceholderProps, SurfaceRegion, type SurfaceRegionProps, hashSlotHue, isSlotDebugEnabled, useLocalSize };

package/dist/react.js

@@ -1,6 +1,6 @@
 import {
   shouldShowDetachedPlaceholder
-} from "./chunk-ZYCR2LSP.js";
+} from "./chunk-EEPX63DF.js";
 
 // src/react.tsx
 import { createElement } from "react";
@@ -261,6 +261,24 @@ function ResizeHandle({
 
 // src/panel.tsx
 import { jsx as jsx3, jsxs } from "react/jsx-runtime";
+function PanelEmptyState({
+  title,
+  detail,
+  className,
+  ...props
+}) {
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ...props,
+      className: className ? `fx-panel-empty ${className}` : "fx-panel-empty",
+      children: [
+        /* @__PURE__ */ jsx3("div", { className: "fx-panel-empty-title", children: title }),
+        detail == null ? null : /* @__PURE__ */ jsx3("div", { className: "fx-panel-empty-detail", children: detail })
+      ]
+    }
+  );
+}
 function PanelSurface({
   id,
   registered = false,
@@ -394,6 +412,7 @@ export {
   DetachedPanelBoundary,
   DetachedSurfaceFrame,
   DetachedSurfaceStatus,
+  PanelEmptyState,
   PanelSurface,
   ResizeHandle,
   ShellSlot,

package/dist/window.d.ts

@@ -82,10 +82,23 @@ interface PanelWindowingController {
     openPanelWindow(panelId: string, capability: DetachedWindowCapability | undefined, options: OpenPanelWindowOptions): Promise<boolean>;
     panelForClosedSurface(surface: SurfaceDescriptor): string | undefined;
 }
+interface CreateSurfaceWindowingControllerOptions {
+    readonly manager: WindowManager;
+    readonly beforeDetach?: (surface: SurfaceDescriptor) => void;
+}
+interface SurfaceWindowingController {
+    snapshot(): Readonly<Record<string, true>>;
+    onChange(listener: () => void): () => void;
+    detachSurface(surface: SurfaceDescriptor, options?: DetachWindowOptions): Promise<boolean>;
+    redockSurface(surface: SurfaceDescriptor): Promise<void>;
+    markSurfaceDocked(surface: SurfaceDescriptor): void;
+}
 declare function canOpenPanelWindow(capability: DetachedWindowCapability | undefined, carrierAvailable: boolean): capability is DetachedWindowCapability;
 declare function shouldShowDetachedPlaceholder(floatingSurfaces: Readonly<Record<string, true>>, surface: SurfaceDescriptor): boolean;
 /** Product-neutral transaction joining a dock placement to a detached carrier. */
 declare function createPanelWindowingController(): PanelWindowingController;
+/** Product-neutral state machine joining floating presentation to a carrier. */
+declare function createSurfaceWindowingController(options: CreateSurfaceWindowingControllerOptions): SurfaceWindowingController;
 /** 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. */
@@ -99,4 +112,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 BrowserPopupWindow, type BrowserWindowHost, type CreateBrowserWindowManagerOptions, type CreateExternalWindowManagerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type OpenPanelWindowOptions, type PanelWindowingController, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type WindowManager, canOpenPanelWindow, createBrowserWindowManager, createExternalWindowManager, createPanelWindowingController, decodeSurfaceFromLocation, encodeSurfaceQuery, shouldShowDetachedPlaceholder, surfaceKey, surfaceWindowLabel };
+export { type BrowserPopupWindow, type BrowserWindowHost, type CreateBrowserWindowManagerOptions, type CreateExternalWindowManagerOptions, type CreateSurfaceWindowingControllerOptions, type DetachWindowOptions, type DetachedWindowCapability, type DetachedWindowTarget, type ExternalWindowHandle, type ExternalWindowHost, type ExternalWindowLifecycle, type OpenPanelWindowOptions, type PanelWindowingController, type SurfaceDescriptor, type SurfaceKind, type SurfacePane, type SurfaceWindowingController, type WindowManager, canOpenPanelWindow, createBrowserWindowManager, createExternalWindowManager, createPanelWindowingController, createSurfaceWindowingController, decodeSurfaceFromLocation, encodeSurfaceQuery, shouldShowDetachedPlaceholder, surfaceKey, surfaceWindowLabel };

package/dist/window.js

@@ -3,17 +3,19 @@ import {
   createBrowserWindowManager,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,
   surfaceKey,
   surfaceWindowLabel
-} from "./chunk-ZYCR2LSP.js";
+} from "./chunk-EEPX63DF.js";
 export {
   canOpenPanelWindow,
   createBrowserWindowManager,
   createExternalWindowManager,
   createPanelWindowingController,
+  createSurfaceWindowingController,
   decodeSurfaceFromLocation,
   encodeSurfaceQuery,
   shouldShowDetachedPlaceholder,

package/package.json

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