import * as react_jsx_runtime from 'react/jsx-runtime';
import * as React from 'react';
import { ResponsiveAction } from './responsive-action-row.js';

/**
 * Library access role for shared hubs. Mirrors
 * `apps/web/lib/collaborator-access.ts > CollaboratorAccessRole` — kept
 * structurally identical so the apps/web type and this type are mutually
 * assignable wherever consumers pass collaborator rosters to `PageHeader`.
 */
type PageHeaderCollaboratorAccessRole = "owner" | "editor" | "commenter" | "viewer";
type PageHeaderVariant = "default" | "collaboration";
/**
 * The action-row limits now live with the row itself
 * (`responsive-action-row.tsx`), since the table toolbar answers to the same
 * three. Re-exported under the old names because consumers and tests import
 * them from here.
 */
declare const PAGE_HEADER_MAX_VISIBLE_ACTIONS = 3;
declare const PAGE_HEADER_COMPACT_ACTIONS_MAX_WIDTH_PX = 640;
declare const PAGE_HEADER_OVERFLOW_ONLY_MAX_WIDTH_PX = 520;
/**
 * Type for the page `<h1>`: the display serif, and the only place it is used.
 *
 * 18 rising to 20, down from 20 rising to 24. A page title is the one heading a
 * reader never has to hunt for, since it sits alone at the top of the column with
 * the actions opposite it, so it was buying prominence it did not need and paying
 * for it in the space between itself and the first row of content. Ivy's large
 * x-height means it still reads a size above the surrounding sans at 18.
 *
 * Exported because the record switcher on detail routes renders its own `<h1>`
 * (`PageTitleRecordSwitcher`) and had this string copied out by hand, which is two
 * places for one type scale to drift, and the two sit on sibling routes where the
 * difference would show as a title that changes size when you drill in.
 */
declare const PAGE_TITLE_TYPE_CLASS = "text-lg font-semibold leading-tight tracking-tight text-foreground sm:text-xl font-heading";
/**
 * A page action. Structurally identical to the shared {@link ResponsiveAction}
 * the table toolbar takes, so a command can be moved between the two without
 * being rewritten. Field-level docs live on that type.
 */
type PageHeaderActionItem = ResponsiveAction;
interface PageHeaderCollaborator {
    id: string;
    name: string;
    imageUrl?: string | null;
    initials?: string;
    email?: string;
    access?: PageHeaderCollaboratorAccessRole;
    /** Org / directory role tags (e.g. Faculty, Program coordinator). */
    roles?: string[];
}
interface PageHeaderProps {
    /** Primary page title — rendered as `<h1>` in Ivy Presto serif, or pass a custom node (e.g. record switcher). */
    title: React.ReactNode;
    /** Short descriptor or date shown below the title (and below `accessInfo` when set). */
    subtitle?: React.ReactNode;
    /** Layout preset — `collaboration` enables access line + face row ahead of `actions`. */
    variant?: PageHeaderVariant;
    /**
     * Role / access copy or badges — rendered between the title and subtitle
     * when `variant="collaboration"` (e.g. lock icon + "Editors can modify").
     */
    accessInfo?: React.ReactNode;
    /** People with access — shown as a horizontal row of faces when `variant="collaboration"`. */
    collaborators?: PageHeaderCollaborator[];
    /** Max faces before a `+N` chip — default 3. */
    collaboratorDisplayLimit?: number;
    /** Opens the invite collaborators sheet when a face, overflow chip, or empty-state CTA is activated. */
    onCollaboratorsOpen?: () => void;
    /** Label for the empty-roster header control — default `"Add collaborator"`. */
    addCollaboratorLabel?: string;
    /** Optional slot for right-aligned actions (buttons, selectors, etc.). */
    actions?: React.ReactNode;
    /**
     * Responsive page actions. At most three **row** actions render beside the
     * title (`placement="row"`, default). Items with `placement="overflow"` are
     * tertiary and **always** live under More (Invite people, Export, …).
     * Below the compact width (or on mobile) every visible row action is
     * icon-only with Tip. During WCAG reflow / overflow-only width, **row**
     * secondaries also move into More; the primary CTA stays on the row as
     * icon-only (never in More).
     *
     * Prefer this over `actions` when the controls can be represented as
     * labelled commands. `actions` remains for custom composites.
     */
    actionItems?: PageHeaderActionItem[];
    /** Extra className for the outer wrapper. */
    className?: string;
    /** When false, the title + subtitle are visually hidden (actions remain). */
    showTitleBlock?: boolean;
    /** Keep h1 on routes. Use h2 only when demonstrating the header inside an existing document. */
    headingLevel?: "h1" | "h2";
}
declare function PageHeader({ title, subtitle, variant, accessInfo, collaborators, collaboratorDisplayLimit, onCollaboratorsOpen, addCollaboratorLabel, actions, actionItems, className, showTitleBlock, headingLevel, }: PageHeaderProps): react_jsx_runtime.JSX.Element;

export { PAGE_HEADER_COMPACT_ACTIONS_MAX_WIDTH_PX, PAGE_HEADER_MAX_VISIBLE_ACTIONS, PAGE_HEADER_OVERFLOW_ONLY_MAX_WIDTH_PX, PAGE_TITLE_TYPE_CLASS, PageHeader, type PageHeaderActionItem, type PageHeaderCollaborator, type PageHeaderCollaboratorAccessRole, type PageHeaderProps, type PageHeaderVariant };