@versaur/react 1.0.13 → 1.0.15

package/dist/blocks.d.ts

@@ -98,10 +98,6 @@ declare interface AppLayoutType extends ForwardRefExoticComponent<AppLayoutRootP
     SideRight: ForwardRefExoticComponent<AppLayoutRegionProps & RefAttributes<HTMLElement>>;
 }
 
-declare interface AsProp<C extends ElementType = ElementType> {
-    as?: C;
-}
-
 export declare namespace AttributeList {
     export type Layout = AttributeList_2.Layout;
     export type Props = AttributeListProps;
@@ -891,111 +887,6 @@ export declare interface ModalRootProps extends Omit<DialogHTMLAttributes<HTMLDi
     children?: ReactNode;
 }
 
-/**
- * Namespace merging: Nav.Item syntax
- */
-export declare const Nav: ForwardRefExoticComponent<NavProps & RefAttributes<HTMLElement>> & {
-    Item: ForwardRefExoticComponent<Omit<NavItemProps, "ref"> & RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
-};
-
-/**
- * NavItem - Polymorphic navigation item
- *
- * Renders as button by default, but supports any element type (a, Link, custom).
- * Supports left and right icons for flexible composition.
- *
- * Can be used in two modes:
- * - Uncontrolled: Pass `active` prop and handle clicks with `onClick`
- * - Controlled: Use within Nav with `value` and let Nav manage active state
- *
- * @example
- * ```tsx
- * // Uncontrolled
- * <Nav>
- *   <Nav.Item active onClick={handleHome}>Home</Nav.Item>
- *   <Nav.Item>Docs</Nav.Item>
- * </Nav>
- *
- * // Controlled (recommended)
- * const [active, setActive] = useState('home');
- * <Nav value={active} onChange={setActive}>
- *   <Nav.Item value="home">Home</Nav.Item>
- *   <Nav.Item value="docs">Docs</Nav.Item>
- * </Nav>
- *
- * // With icons
- * <Nav.Item leftIcon={HomeIcon} value="home">Home</Nav.Item>
- * <Nav.Item rightIcon={ChevronIcon} value="more">More</Nav.Item>
- * ```
- */
-export declare const NavItem: ForwardRefExoticComponent<Omit<NavItemProps, "ref"> & RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
-
-/**
- * NavItem base props
- */
-declare interface NavItemBaseProps {
-    /**
-     * Whether this nav item represents current page (uncontrolled)
-     * Sets aria-current="page" for anchor/Link elements
-     * Ignored if Nav has value/onChange (controlled mode)
-     */
-    active?: boolean;
-    /**
-     * Unique identifier for this item in controlled mode
-     * When Nav has onChange, this value is passed to onChange when clicked
-     */
-    value?: string | number;
-    /**
-     * Icon to render on the left side of the text
-     */
-    leftIcon?: ComponentType<SVGProps<SVGSVGElement>>;
-    /**
-     * Icon to render on the right side of the text
-     */
-    rightIcon?: ComponentType<SVGProps<SVGSVGElement>>;
-    /**
-     * Loading state - disables interaction and shows visual loading indicator
-     */
-    loading?: boolean;
-    /**
-     * Disabled state - prevents all interactions
-     */
-    disabled?: boolean;
-    children?: ReactNode;
-}
-
-/**
- * Polymorphic NavItem type
- * Defaults to "button" but supports "a", Next.js Link, React Router Link, or any custom component
- */
-export declare type NavItemProps<C extends ElementType = ElementType> = PolymorphicProps<C, NavItemBaseProps>;
-
-/**
- * Nav props
- */
-export declare interface NavProps extends Omit<HTMLAttributes<HTMLElement>, "onChange"> {
-    /**
-     * Layout direction for the navigation container
-     * @default "horizontal"
-     */
-    direction?: "horizontal" | "vertical";
-    /**
-     * Gap between nav items
-     * Uses Versaur spacing scale: xs, sm, md, lg
-     */
-    gap?: "xs" | "sm" | "md" | "lg";
-    /**
-     * Controlled value - which nav item is currently active
-     * @default undefined
-     */
-    value?: string | number;
-    /**
-     * Callback when a nav item is selected
-     */
-    onChange?: (value: string | number) => void;
-    children?: ReactNode;
-}
-
 /**
  * NoResults component - displays an empty state with icon, title, subtitle, and optional action
  *
@@ -1069,7 +960,34 @@ declare interface OverlayTitleProps extends HTMLAttributes<HTMLHeadingElement> {
     as?: ElementType;
 }
 
-declare type PolymorphicProps<C extends ElementType = ElementType, Props = {}> = Props & AsProp<C> & Omit<React.ComponentPropsWithoutRef<C>, keyof Props | "as">;
+export declare const PageHeader: PageHeaderComponent;
+
+export declare interface PageHeaderComponent extends ForwardRefExoticComponent<PageHeaderRootProps & RefAttributes<HTMLElement>> {
+    Title: ForwardRefExoticComponent<PageHeaderTitleProps & RefAttributes<HTMLDivElement>>;
+    Subtitle: ForwardRefExoticComponent<PageHeaderSubtitleProps & RefAttributes<HTMLElement>>;
+}
+
+export declare interface PageHeaderRootProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    title?: ReactNode;
+    subtitle?: ReactNode;
+    supplementary?: ReactNode;
+}
+
+/** Alias for Text — all TextProps forwarded to the internal <Text> */
+export declare interface PageHeaderSubtitleProps extends HTMLAttributes<HTMLParagraphElement> {
+    /** Content rendered to the right of the subtitle text */
+    additionalInfo?: ReactNode;
+    children?: ReactNode;
+}
+
+/** Exposes Heading visual props — all forwarded to the internal <Heading> */
+export declare interface PageHeaderTitleProps extends Pick<HTMLAttributes<HTMLDivElement>, "className" | "style"> {
+    /** Icon/button rendered to the right of the heading text. Activates sub-grid layout. */
+    action?: ReactNode;
+    /** Content rendered below the heading row (badges, status chips, etc.) */
+    additionalInfo?: ReactNode;
+    children?: ReactNode;
+}
 
 /**
  * Compound Sidebar component with sub-components
@@ -1406,6 +1324,14 @@ export declare interface TabsItemProps extends Omit<React.HTMLAttributes<HTMLDiv
      * Whether the item is disabled
      */
     disabled?: boolean;
+    /**
+     * Icon element to display on the left side
+     */
+    leftIcon?: ReactNode;
+    /**
+     * Icon element to display on the right side
+     */
+    rightIcon?: ReactNode;
     /**
      * The content of the item
      */