@forgeax/app-shell 0.35.0 → 0.37.0

package/dist/react.d.ts

@@ -1,6 +1,7 @@
 import * as react from 'react';
 import { ReactElement, HTMLAttributes, ReactNode } from 'react';
 import { DetachedWindowCapability } from './window.js';
+import { DockLayoutControlSnapshot, DockLayoutPanelControl, DockLayoutControlState, DockLayoutControlToggleSource } from './dock.js';
 
 /** Stable FNV-1a color bucket for a shell slot name. */
 declare function hashSlotHue(name: string): number;
@@ -90,6 +91,20 @@ interface SurfaceRegionProps extends Omit<HTMLAttributes<HTMLDivElement>, 'child
 /** Product-neutral full-size surface region with an explicit fill body. */
 declare const SurfaceRegion: react.ForwardRefExoticComponent<SurfaceRegionProps & react.RefAttributes<HTMLDivElement>>;
 
+interface DockLayoutControlBindingOptions<Anchor> {
+    state: DockLayoutControlState<Anchor>;
+    onToggle: DockLayoutControlToggleSource<Anchor>['onToggle'];
+    isPanelOpen(panelId: string): boolean;
+    closePanel(panelId: string): void;
+    reopenPanel(panelId: string): void;
+}
+interface DockLayoutControlBinding<Anchor> {
+    readonly snapshot: DockLayoutControlSnapshot<Anchor>;
+    readonly panelControl: DockLayoutPanelControl;
+}
+/** Bind the product-neutral layout-control state, toggle source, and live panel projection to React. */
+declare function useDockLayoutControlBinding<Anchor>({ state, onToggle, isPanelOpen, closePanel, reopenPanel, }: DockLayoutControlBindingOptions<Anchor>): DockLayoutControlBinding<Anchor>;
+
 type ShellSlotElement = 'aside' | 'div' | 'main' | 'section';
 interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
     as?: ShellSlotElement;
@@ -98,4 +113,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, PanelEmptyState, type PanelEmptyStateProps, 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 DockLayoutControlBinding, type DockLayoutControlBindingOptions, 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, useDockLayoutControlBinding, useLocalSize };

package/dist/react.js

@@ -1,3 +1,7 @@
+import {
+  createDockLayoutPanelControl,
+  installDockLayoutControlToggle
+} from "./chunk-MYY2LEZI.js";
 import {
   shouldShowDetachedPlaceholder
 } from "./chunk-QMT4V6XC.js";
@@ -400,6 +404,29 @@ var SurfaceRegion = forwardRef(
   }
 );
 
+// src/dock-layout-control.ts
+import { useEffect as useEffect3, useMemo, useSyncExternalStore } from "react";
+function useDockLayoutControlBinding({
+  state,
+  onToggle,
+  isPanelOpen,
+  closePanel,
+  reopenPanel
+}) {
+  const snapshot = useSyncExternalStore(
+    state.subscribe,
+    state.getSnapshot,
+    state.getSnapshot
+  );
+  useEffect3(() => installDockLayoutControlToggle({ onToggle }, state), [onToggle, state]);
+  const panelControl = useMemo(() => createDockLayoutPanelControl({
+    isOpen: isPanelOpen,
+    close: closePanel,
+    reopen: reopenPanel
+  }), [closePanel, isPanelOpen, reopenPanel]);
+  return useMemo(() => ({ snapshot, panelControl }), [panelControl, snapshot]);
+}
+
 // src/react.tsx
 function ShellSlot({
   as = "div",
@@ -421,5 +448,6 @@ export {
   SurfaceRegion,
   hashSlotHue,
   isSlotDebugEnabled,
+  useDockLayoutControlBinding,
   useLocalSize
 };

package/package.json

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