@exegia/corpora-ui 0.18.0 → 0.19.0

package/dist-lib/components/blocks/scaffold/constants.d.ts

@@ -2,6 +2,9 @@
 export declare const SCAFFOLD_SIDEBAR_WIDTH = 64;
 /** Inspector drawer width in px. */
 export declare const SCAFFOLD_INSPECTOR_WIDTH = 272;
+/** Most panels the canvas holds at once — omit Actions' `onAdd` when the
+ * count reaches it so the Add segment hides. */
+export declare const SCAFFOLD_PANEL_CAPACITY = 3;
 /** Gap in px between the drawer/actions and the viewport edges. */
 export declare const SCAFFOLD_EDGE_GUTTER = 10;
 /** Vertical room in px reserved above the canvas for the actions cluster. */

package/dist-lib/components/blocks/scaffold/index.d.ts

@@ -7,12 +7,13 @@ import { ScaffoldMain } from './scaffold-main';
 import { ScaffoldPanel } from './scaffold-panel';
 import { ScaffoldRoot } from './scaffold-root';
 import { ScaffoldSidebar } from './scaffold-sidebar';
+import { ScaffoldTab } from './scaffold-tab';
 import { ScaffoldSubPanel } from './scaffold-sub-panel.tsx';
 export { useScaffoldContext } from './scaffold-context';
 export { useScaffold } from './use-scaffold';
 export type * from './type';
 export * from './constants';
-export { PanelCloseButton, PanelMenuButton, ScaffoldActions, ScaffoldCanvas, ScaffoldInspector, ScaffoldMain, ScaffoldPanel, ScaffoldRoot, ScaffoldSidebar, };
+export { PanelCloseButton, PanelMenuButton, ScaffoldActions, ScaffoldCanvas, ScaffoldInspector, ScaffoldMain, ScaffoldPanel, ScaffoldRoot, ScaffoldSidebar, ScaffoldTab, };
 export declare const Scaffold: {
     Root: typeof ScaffoldRoot;
     Sidebar: typeof ScaffoldSidebar;
@@ -20,6 +21,7 @@ export declare const Scaffold: {
     Actions: typeof ScaffoldActions;
     Canvas: typeof ScaffoldCanvas;
     Panel: typeof ScaffoldPanel;
+    Tab: typeof ScaffoldTab;
     Inspector: typeof ScaffoldInspector;
     SubPanel: typeof ScaffoldSubPanel;
 };

package/dist-lib/components/blocks/scaffold/panel-menu-button.d.ts

@@ -1,7 +1,8 @@
 import { PanelMenuButtonProps } from './type';
 import * as React from "react";
 /**
- * Floating swap affordance centered on the seam between a panel's primary
- * surface and its secondary strip.
+ * Floating menu affordance centered on the seam between a panel's primary
+ * surface and its secondary strip: a compact ⋯ toggle that morphs into the
+ * Expand | Swap (| Close) actions.
  */
-export declare function PanelMenuButton({ onClick, onExpand, secondaryExpanded, label, sound, className, }: PanelMenuButtonProps): React.ReactElement;
+export declare function PanelMenuButton({ onClick, onExpand, onCloseSecondary, secondaryExpanded, swapped, label, sound, className, }: PanelMenuButtonProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-actions.d.ts

@@ -2,8 +2,9 @@ import { ScaffoldActionsProps } from './type';
 import * as React from "react";
 /**
  * The floating pill cluster in the main region's top-right corner — the
- * design's "Panel Context Menu": an Add segment plus an overflow segment
- * whose badge counts the non-visible panels. Slides left in step with the
- * inspector opening.
+ * design's "Panel Context Menu": one tab per open panel (`Scaffold.Tab`
+ * children) plus an Add segment. Add renders only while `onAdd` is
+ * present — omit it once the canvas holds `SCAFFOLD_PANEL_CAPACITY`
+ * panels. Slides left in step with the inspector opening.
  */
-export declare function ScaffoldActions({ onAdd, addLabel, addIcon, overflowCount, onBrowse, browseLabel, sound, className, children, ...rest }: ScaffoldActionsProps): React.ReactElement;
+export declare function ScaffoldActions({ onAdd, addLabel, addIcon, sound, className, children, ...rest }: ScaffoldActionsProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-panel.d.ts

@@ -7,4 +7,4 @@ import * as React from "react";
  * the two cards with a layout morph — the strip glides up and grows into the
  * primary slot while the primary card shrinks down into the strip.
  */
-export declare function ScaffoldPanel({ children, SecondaryPanel, onClose, onSwap, name, closeLabel, swapLabel, sound, className, }: ScaffoldPanelProps): React.ReactElement;
+export declare function ScaffoldPanel({ children, SecondaryPanel, onSwap, onCloseSecondary, name, swapLabel, sound, className, }: ScaffoldPanelProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-tab.d.ts

@@ -0,0 +1,9 @@
+import { ScaffoldTabProps } from './type';
+import * as React from "react";
+/**
+ * A panel's tab inside the action cluster: its label plus a close
+ * affordance. Render one per open panel as Actions children, keyed —
+ * closes animate out of the pill. Omit `onClose` on the last remaining
+ * panel's tab; the canvas keeps at least one panel open.
+ */
+export declare function ScaffoldTab({ children, onClose, closeLabel, sound, className, ...rest }: ScaffoldTabProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/type.d.ts

@@ -25,23 +25,16 @@ export type ScaffoldCanvasProps = ComponentProps<"div">;
  * on `motion.*` elements — strip them from pass-through HTML props. */
 type MotionSafe<T> = Omit<T, "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart" | "onAnimationEnd" | "onAnimationIteration">;
 export interface ScaffoldActionsProps extends MotionSafe<Omit<ComponentProps<"div">, "children">> {
-    /** Called when the Add segment is pressed. */
+    /** Called when the Add segment is pressed. The segment renders only
+     * while this is present — omit it to hide Add, e.g. once the canvas
+     * holds `SCAFFOLD_PANEL_CAPACITY` panels. */
     onAdd?: () => void;
     /** Label of the Add segment. */
     addLabel?: ReactNode;
     /** Replaces the default add icon. */
     addIcon?: ReactNode;
-    /** Number of non-visible panels tucked into the overflow dropdown —
-     * the badge on the browse segment. The segment renders when this or
-     * `onBrowse` is present; the badge only when > 0. Per the design
-     * comments the dropdown menu itself is a later iteration; for now the
-     * segment just keeps the count. */
-    overflowCount?: number;
-    /** Called when the overflow (stacked-panels) segment is pressed. */
-    onBrowse?: () => void;
-    /** Accessible name of the overflow segment. */
-    browseLabel?: string;
-    /** Extra segments appended after the built-in ones. */
+    /** The panel tabs (`Scaffold.Tab`, one per open panel) and any extra
+     * segments, rendered before Add. Key each tab — closes animate out. */
     children?: ReactNode;
     /** Emit interaction-sound attributes (inert until an app binds cuelume). */
     sound?: boolean;
@@ -52,31 +45,34 @@ export interface ScaffoldPanelProps {
     children: ReactNode;
     /** The panel's content, rendered in a card with a drop shadow. */
     SecondaryPanel?: TScaffoldPanelChild;
-    /** Renders the floating close button in the panel's top-right corner. */
-    onClose?: () => void;
-    /** Renders the floating swap button over the primary/secondary gap.
-     * Only shown when `secondary` is present. Clicking it trades the two
-     * cards with a layout morph — flip the slot content here so each card
-     * carries its subject to its new home. */
+    /** Reveals the Swap action in the seam menu (needs `SecondaryPanel`).
+     * Swapping trades the two cards with a layout morph — flip the slot
+     * content here so each card carries its subject to its new home. */
     onSwap?: () => void;
-    /** Controlled swap state — while true the strip's card sits in the
-     * primary slot. Omit letting the panel toggle it on swap clicks. */
-    swapped?: boolean;
-    /** Initial swap state when uncontrolled. */
-    defaultSwapped?: boolean;
-    /** Fixed width in px; omitted, the panel flexes to share the canvas. */
-    width?: number;
+    /** Reveals the Close action in the seam menu — remove `SecondaryPanel`
+     * here; the strip and the menu leave together. */
+    onCloseSecondary?: () => void;
     /** Accessible name of the panel region. */
     name?: string;
     /** Emit interaction-sound attributes on the floating buttons. */
     sound?: boolean;
-    /** Accessible name of the close button. */
-    closeLabel?: string;
-    /** Accessible name of the swap button. */
+    /** Accessible name of the seam-menu toggle. */
     swapLabel?: string;
     /** Extra class names for the panel's root element. */
     className?: string;
 }
+export interface ScaffoldTabProps extends MotionSafe<Omit<ComponentProps<"div">, "children">> {
+    /** The tab's label. */
+    children?: ReactNode;
+    /** Renders the tab's close button. The button renders only while this
+     * is present — omit it to pin the tab, e.g. on the last remaining
+     * panel (the canvas keeps at least one open). */
+    onClose?: () => void;
+    /** Accessible name of the close button. */
+    closeLabel?: string;
+    /** Emit interaction-sound attributes on the close button. */
+    sound?: boolean;
+}
 export type TSubPanelPosition = "bottom" | "top";
 export type TSubPanelVariant = "card" | "subtle" | "inset";
 export interface ScaffoldSubPanelProps extends MotionSafe<Omit<ComponentProps<"div">, "children">> {
@@ -113,9 +109,15 @@ export interface PanelMenuButtonProps extends PanelFloatingButtonProps {
     /** Called when the Expand action is pressed — the panel trades which
      * sub-panel holds the flexible slot. */
     onExpand?: () => void;
+    /** Renders the Close action; called when it is pressed — the consumer
+     * removes the secondary strip. */
+    onCloseSecondary?: () => void;
     /** Whether the secondary strip currently holds the flexible slot —
      * flips the Expand chevron between down and up. */
     secondaryExpanded?: boolean;
+    /** Whether the panel is swapped (column-reverse). Mirrors the Expand
+     * chevron so it keeps pointing at the sub-panel that grows next. */
+    swapped?: boolean;
 }
 export interface UseScaffoldOptions {
     /** Initial inspector state. Closed by default. */

package/dist-lib/components/blocks/scaffold/utils.d.ts

@@ -1,3 +1,4 @@
+import { Variants } from 'motion/react';
 import { ClassNameValue } from 'tailwind-merge';
 import { TSubPanelVariant } from './type.ts';
 /** Desktop backdrop the whole scaffold sits on — a soft warm-gray wash. */
@@ -11,5 +12,10 @@ export declare const floatingButtonClass: ClassNameValue;
 export declare const revealOnPanelHoverClass: ClassNameValue;
 /** Pill segment inside the actions cluster (Add, browse). */
 export declare const actionSegmentClass: ClassNameValue;
+/** Pill segments (seam-menu actions, tabs, Add) blur/fade in place while
+ * the track morphs around them. The exit is a fast tween, not the layout
+ * spring — the track stays overflow-visible, so popped-out segments must be
+ * gone before the shrinking pill leaves them behind as a ghost. */
+export declare const segmentVariants: Variants;
 /** Map of sub-panel variants to their corresponding side. */
 export declare const subPanelVariant: Record<TSubPanelVariant, ClassNameValue>;