@forgeax/app-shell 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/detached.css CHANGED
@@ -10,3 +10,11 @@
10
10
  min-height: 0;
11
11
  height: 100%;
12
12
  }
13
+
14
+ .fx-detached-surface-status-text[data-tone="neutral"] {
15
+ color: #888;
16
+ }
17
+
18
+ .fx-detached-surface-status-text[data-tone="error"] {
19
+ color: #c44;
20
+ }
package/dist/react.d.ts CHANGED
@@ -56,8 +56,23 @@ interface DetachedSurfaceFrameProps {
56
56
  /** Center caller-owned status content inside the full-window frame. */
57
57
  centered?: boolean;
58
58
  }
59
+ type DetachedSurfaceStatusTone = 'neutral' | 'error';
60
+ interface DetachedSurfaceStatusProps {
61
+ children: ReactNode;
62
+ tone?: DetachedSurfaceStatusTone;
63
+ }
59
64
  /** Product-neutral presentation frame for content mounted in a detached window. */
60
65
  declare function DetachedSurfaceFrame({ children, panel, centered, }: DetachedSurfaceFrameProps): ReactElement;
66
+ /** Product-neutral status text for a detached frame; callers retain the copy. */
67
+ declare function DetachedSurfaceStatus({ children, tone, }: DetachedSurfaceStatusProps): ReactElement;
68
+
69
+ interface SurfacePlaceholderProps {
70
+ title: ReactNode;
71
+ /** Optional caller-owned modifier; product variants remain outside App Shell. */
72
+ className?: string;
73
+ }
74
+ /** Product-neutral empty renderer placeholder with stable shell hooks. */
75
+ declare function SurfacePlaceholder({ title, className, }: SurfacePlaceholderProps): ReactElement;
61
76
 
62
77
  type ShellSlotElement = 'aside' | 'div' | 'main' | 'section';
63
78
  interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
@@ -67,4 +82,4 @@ interface ShellSlotProps extends HTMLAttributes<HTMLElement> {
67
82
  /** Structural shell marker that preserves the caller's semantic element. */
68
83
  declare function ShellSlot({ as, name, ...props }: ShellSlotProps): ReactElement;
69
84
 
70
- export { DetachedPanelBoundary, type DetachedPanelBoundaryProps, DetachedSurfaceFrame, type DetachedSurfaceFrameProps, type PanelContentPadding, type PanelContentPolicy, type PanelContentScroll, type PanelContentTone, PanelSurface, type PanelSurfaceProps, ResizeHandle, type ResizeHandleProps, ShellSlot, type ShellSlotElement, type ShellSlotProps, SlotDebugOverlay, hashSlotHue, isSlotDebugEnabled, useLocalSize };
85
+ 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, hashSlotHue, isSlotDebugEnabled, useLocalSize };
package/dist/react.js CHANGED
@@ -337,6 +337,21 @@ function DetachedSurfaceFrame({
337
337
  }
338
338
  );
339
339
  }
340
+ function DetachedSurfaceStatus({
341
+ children,
342
+ tone = "neutral"
343
+ }) {
344
+ return /* @__PURE__ */ jsx4("span", { className: "fx-detached-surface-status-text", "data-tone": tone, children });
345
+ }
346
+
347
+ // src/surface-placeholder.tsx
348
+ import { jsx as jsx5 } from "react/jsx-runtime";
349
+ function SurfacePlaceholder({
350
+ title,
351
+ className
352
+ }) {
353
+ return /* @__PURE__ */ jsx5("div", { className: className ? `surface-placeholder ${className}` : "surface-placeholder", children: /* @__PURE__ */ jsx5("div", { className: "surface-placeholder-title", children: title }) });
354
+ }
340
355
 
341
356
  // src/react.tsx
342
357
  function ShellSlot({
@@ -349,10 +364,12 @@ function ShellSlot({
349
364
  export {
350
365
  DetachedPanelBoundary,
351
366
  DetachedSurfaceFrame,
367
+ DetachedSurfaceStatus,
352
368
  PanelSurface,
353
369
  ResizeHandle,
354
370
  ShellSlot,
355
371
  SlotDebugOverlay,
372
+ SurfacePlaceholder,
356
373
  hashSlotHue,
357
374
  isSlotDebugEnabled,
358
375
  useLocalSize
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forgeax/app-shell",
3
- "version": "0.17.0",
3
+ "version": "0.19.0",
4
4
  "description": "Generic Dock, Panel, Window, and Slot composition primitives",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",