import type { CategoricalIndex } from "@charcuterie/tokens";
import type { ReactNode } from "react";
import type { TimelineSpan, TimelineTitleLayout } from "./laneTimelineGeometry.ts";
/**
 * Who owns the item's activation — nobody, a router, or a handler.
 *
 * A union rather than two loose optionals, the same call
 * `BoardItemTitleLink` makes and for the same reason: `href` renders
 * an `<a>` and `onSelect` renders a `<button>`, so a bar carrying
 * both is one of them with the other silently dropped. On screen the
 * two are identical.
 */
type TimelineItemAction = {
    /**
     * Where the bar navigates. Routed through
     * `RouterLinkProvider` like every other `href` in this
     * library.
     */
    href?: string;
    onSelect?: never;
} | {
    href?: never;
    /** For a timeline that opens a panel rather than a route. */
    onSelect?: () => void;
};
export type TimelineItem = TimelineSpan & {
    /**
     * The bar's colour, when somebody has chosen one. Omitted, it is
     * the **lane's**, because on this component colour means *which
     * lane* — an item that picked its own hue out of the ten would
     * read as belonging somewhere else. Pass this only when the item
     * genuinely carries its own identity, and then put that identity
     * in words too.
     */
    categorical?: CategoricalIndex;
    key: string;
    /**
     * The words. A **string**, not a `ReactNode`, for the reason
     * `BoardLane.label` is one: the same value goes into the bar's
     * accessible name, the `title` a hovering reader gets, and the
     * Narrow View's row — none of which can hold a node.
     */
    title: string;
} & TimelineItemAction;
export type LaneTimelineBarProps = {
    className?: string;
    item: TimelineItem;
    /** The lane's hue, used when the item picked none. */
    laneCategorical: CategoricalIndex;
    /** What the bar says out loud: title, then the span in words. */
    description: string;
    /** Square the leading edge — the item began before this range. */
    hasEarlierStart: boolean;
    /** Square the trailing edge — it runs past this range. */
    hasLaterEnd: boolean;
    /**
     * `bar` is the block on the axis. `row` is the Narrow View's
     * full-width line, where the same item has room for two lines of
     * text and no position to carry meaning.
     */
    shape: "bar" | "row";
    /**
     * For the `bar` shape only: `clip` prints the title on one line
     * with an ellipsis, `wrap` lets it run onto up to three. The
     * timeline chooses from the measured column width, so a bar
     * never decides this for itself. Default `clip`.
     */
    titleLayout?: TimelineTitleLayout;
};
/**
 * One item, in either of the two shapes this component draws it in.
 *
 * ### The name is the whole of the accessibility argument
 *
 * A bar means something by **where it sits and how long it is**, and
 * neither of those reaches a screen reader. Nor does the hue: ten
 * categorical colours carry *which lane*, and colour alone failing
 * WCAG 1.4.1 is the least of it — the lane is already a named group,
 * so the colour is reinforcement rather than information.
 *
 * What is genuinely only in the geometry is the **span**, so every
 * bar carries it as text: `description` is appended to the title in
 * a `VisuallyHidden` and repeated in the `title` attribute. That
 * second one is not an accessibility feature, it is for the sighted
 * reader: a one-day bar is about twenty pixels wide and cannot show
 * its own name at all.
 *
 * A native `title` rather than `Tooltip`, deliberately. A household
 * week is two hundred bars, and two hundred floating-ui instances to
 * describe boxes that are already described is a cost with nothing
 * on the other side of it.
 *
 * ### The clipped edge is square, and it is also in words
 *
 * An item running out of the visible range loses the radius on that
 * edge, which is the convention every Gantt chart uses. It is **not**
 * the only signal:
 * `description` already says "starts before this range", because a
 * missing corner is not something anybody perceives without the
 * unclipped bar beside it to compare against.
 */
export declare const LaneTimelineBar: ({ className, description, hasEarlierStart, hasLaterEnd, item, laneCategorical, shape, titleLayout, }: LaneTimelineBarProps) => ReactNode;
export {};
//# sourceMappingURL=LaneTimelineBar.d.ts.map