@forgeax/app-shell 0.18.0 → 0.20.0

package/dist/react.d.ts

@@ -66,6 +66,24 @@ declare function DetachedSurfaceFrame({ children, panel, centered, }: DetachedSu
 /** Product-neutral status text for a detached frame; callers retain the copy. */
 declare function DetachedSurfaceStatus({ children, tone, }: DetachedSurfaceStatusProps): ReactElement;
 
+interface SurfacePlaceholderProps {
+    title: ReactNode;
+    /** Optional caller-owned modifier; product variants remain outside App Shell. */
+    className?: string;
+}
+/** Product-neutral empty renderer placeholder with stable shell hooks. */
+declare function SurfacePlaceholder({ title, className, }: SurfacePlaceholderProps): ReactElement;
+
+interface SurfaceRegionProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    children: ReactNode;
+    /** Caller-owned content layered outside the fill body. */
+    overlay?: ReactNode;
+    /** Optional caller-owned modifier for the fill body. */
+    bodyClassName?: string;
+}
+/** Product-neutral full-size surface region with an explicit fill body. */
+declare const SurfaceRegion: react.ForwardRefExoticComponent<SurfaceRegionProps & react.RefAttributes<HTMLDivElement>>;
+
 type ShellSlotElement = 'aside' | 'div' | 'main' | 'section';
 interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
     as?: ShellSlotElement;
@@ -74,4 +92,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, hashSlotHue, isSlotDebugEnabled, useLocalSize };
+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 };

package/dist/react.js

@@ -344,6 +344,44 @@ function DetachedSurfaceStatus({
   return /* @__PURE__ */ jsx4("span", { className: "fx-detached-surface-status-text", "data-tone": tone, children });
 }
 
+// src/surface-placeholder.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+function SurfacePlaceholder({
+  title,
+  className
+}) {
+  return /* @__PURE__ */ jsx5("div", { className: className ? `surface-placeholder ${className}` : "surface-placeholder", children: /* @__PURE__ */ jsx5("div", { className: "surface-placeholder-title", children: title }) });
+}
+
+// src/surface-region.tsx
+import {
+  forwardRef
+} from "react";
+import { jsx as jsx6, jsxs as jsxs2 } from "react/jsx-runtime";
+var joinClassNames = (base, modifier) => modifier ? `${base} ${modifier}` : base;
+var SurfaceRegion = forwardRef(
+  function SurfaceRegion2({
+    children,
+    overlay,
+    className,
+    bodyClassName,
+    ...props
+  }, ref) {
+    return /* @__PURE__ */ jsxs2(
+      "div",
+      {
+        ...props,
+        ref,
+        className: joinClassNames("fx-surface-region", className),
+        children: [
+          overlay == null ? null : /* @__PURE__ */ jsx6("div", { className: "fx-surface-region-overlay", children: overlay }),
+          /* @__PURE__ */ jsx6("div", { className: joinClassNames("fx-surface-region-body", bodyClassName), children })
+        ]
+      }
+    );
+  }
+);
+
 // src/react.tsx
 function ShellSlot({
   as = "div",
@@ -360,6 +398,8 @@ export {
   ResizeHandle,
   ShellSlot,
   SlotDebugOverlay,
+  SurfacePlaceholder,
+  SurfaceRegion,
   hashSlotHue,
   isSlotDebugEnabled,
   useLocalSize

package/dist/surface.css

@@ -0,0 +1,19 @@
+.fx-surface-region {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+
+.fx-surface-region-body {
+  flex: 1 1 auto;
+  min-height: 0;
+  display: flex;
+  flex-direction: column;
+}
+
+.fx-surface-region-overlay {
+  display: contents;
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@forgeax/app-shell",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Generic Dock, Panel, Window, and Slot composition primitives",
   "license": "Apache-2.0",
   "type": "module",
-  "sideEffects": ["./dist/resize.css", "./dist/panel.css", "./dist/detached.css"],
+  "sideEffects": ["./dist/resize.css", "./dist/panel.css", "./dist/detached.css", "./dist/surface.css"],
   "files": ["dist"],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,12 +27,13 @@
     },
     "./resize.css": "./dist/resize.css",
     "./panel.css": "./dist/panel.css",
-    "./detached.css": "./dist/detached.css"
+    "./detached.css": "./dist/detached.css",
+    "./surface.css": "./dist/surface.css"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "test": "bun test test",
-    "build": "tsup src/index.ts src/dock.ts src/window.ts src/react.tsx --format esm --dts --outDir dist && bun run scripts/copy-resize-css.ts && bun run scripts/copy-panel-css.ts && bun run scripts/copy-detached-surface-css.ts",
+    "build": "tsup src/index.ts src/dock.ts src/window.ts src/react.tsx --format esm --dts --outDir dist && bun run scripts/copy-resize-css.ts && bun run scripts/copy-panel-css.ts && bun run scripts/copy-detached-surface-css.ts && bun run scripts/copy-surface-css.ts",
     "check": "bun run typecheck && bun run test && bun run build",
     "release:preflight": "bun run scripts/release-preflight.ts"
   },