@arbidocs/blocks 0.3.177 → 0.3.179

package/dist/{index-er1L8kkn.d.cts → index-DduoEosi.d.cts}

@@ -292,6 +292,12 @@ interface TimelineItem {
     end?: string | null;
     /** Longer text shown in the detail panel. */
     description?: string;
+    /**
+     * Up to three CSS colours the bar is painted with — e.g. an item's label
+     * colours. One fills solid; two or three split the bar into equal segments.
+     * Omitted or empty renders a neutral bar; colours past the third are ignored.
+     */
+    colors?: readonly string[];
 }
 
 interface TimelineCalendarProps<T extends TimelineItem = TimelineItem> {
@@ -300,29 +306,86 @@ interface TimelineCalendarProps<T extends TimelineItem = TimelineItem> {
     onSelect?: (item: T) => void;
     /** Bars shown per week before the remainder collapses to "+n more". */
     maxLanes?: number;
+    /** Ids to treat as the current selection — positions the event navigator's
+     *  ‹ n / N › on the matching event (e.g. the one open in the app's editor). */
+    selectedIds?: readonly string[];
+    /**
+     * Where the ‹ n / N › event navigator renders. Omit it for the built-in
+     * inline placement. Pass a host element (e.g. a slot in the app's own
+     * toolbar) to portal the navigator there instead — or `null` while that slot
+     * isn't mounted yet, which renders no navigator at all rather than falling
+     * back inline (avoids a flash of the inline one on first paint).
+     */
+    navigatorContainer?: HTMLElement | null;
+    /**
+     * Denominator shown by the navigator (`n / N`). Defaults to the number of
+     * dated items it can step through; a host may pass its full (filtered) item
+     * count instead so the figure matches the list it shows elsewhere, even when
+     * some of those items carry no date and so never appear here.
+     */
+    navigatorTotal?: number;
     /** Shown when nothing in `items` carries a date. */
     emptyState?: ReactNode;
     className?: string;
     /** Prefix for every `data-testid` this view emits. */
     testId?: string;
 }
-declare function TimelineCalendar<T extends TimelineItem = TimelineItem>({ items, onSelect, maxLanes, emptyState, className, testId, }: TimelineCalendarProps<T>): react.JSX.Element;
+declare function TimelineCalendar<T extends TimelineItem = TimelineItem>({ items, onSelect, selectedIds, maxLanes, navigatorContainer, navigatorTotal, emptyState, className, testId, }: TimelineCalendarProps<T>): react.JSX.Element;
 
 interface TimelineGanttProps<T extends TimelineItem = TimelineItem> {
     items: T[];
     /** The selected item, or null when the panel closes. */
     onSelect?: (item: T | null) => void;
+    /**
+     * Ids to render as selected — e.g. rows a user checked in another view.
+     * Their bar and label are highlighted so the selection carries across views;
+     * this does not open the detail panel (that stays driven by clicks here).
+     */
+    selectedIds?: readonly string[];
     /** Extra detail-panel content for the selected item — sources, links, actions. */
     renderDetail?: (item: T) => ReactNode;
     /** Width of the row-label gutter, in pixels. */
     labelWidth?: number;
+    /**
+     * When provided, the label gutter becomes user-resizable: a drag handle
+     * appears on its right edge and this fires with the new width (px) as the
+     * user drags. The caller owns the value (so it can persist it) and feeds it
+     * back via `labelWidth`.
+     */
+    onLabelWidthChange?: (width: number) => void;
+    /** Clamp for the resizable gutter, in pixels. */
+    minLabelWidth?: number;
+    maxLabelWidth?: number;
+    /**
+     * Controlled date-axis zoom (1 = fit). Provide BOTH `zoom` and `onZoomChange`
+     * to drive it from outside — e.g. a button in the app's own header — which also
+     * suppresses the chart's built-in corner control. Omit them to use the internal
+     * state and the corner control.
+     */
+    zoom?: number;
+    onZoomChange?: (zoom: number) => void;
+    /**
+     * Where the ‹ n / N › event navigator renders. Omit it for the built-in
+     * inline placement. Pass a host element (e.g. a slot in the app's own
+     * toolbar) to portal the navigator there instead — or `null` while that slot
+     * isn't mounted yet, which renders no navigator at all rather than falling
+     * back inline (avoids a flash of the inline one on first paint).
+     */
+    navigatorContainer?: HTMLElement | null;
+    /**
+     * Denominator shown by the navigator (`n / N`). Defaults to the number of
+     * dated items it can step through; a host may pass its full (filtered) item
+     * count instead so the figure matches the list it shows elsewhere, even when
+     * some of those items carry no date and so never appear here.
+     */
+    navigatorTotal?: number;
     /** Shown when nothing in `items` carries a usable date. */
     emptyMessage?: string;
     className?: string;
     /** Prefix for every `data-testid` this view emits. */
     testId?: string;
 }
-declare function TimelineGantt<T extends TimelineItem = TimelineItem>({ items, onSelect, renderDetail, labelWidth, emptyMessage, className, testId, }: TimelineGanttProps<T>): react.JSX.Element;
+declare function TimelineGantt<T extends TimelineItem = TimelineItem>({ items, onSelect, selectedIds, renderDetail, labelWidth, onLabelWidthChange, minLabelWidth, maxLabelWidth, zoom: zoomProp, onZoomChange, navigatorContainer, navigatorTotal, emptyMessage, className, testId, }: TimelineGanttProps<T>): react.JSX.Element;
 
 type TimelineViewMode = 'calendar' | 'gantt';
 interface TimelineProps<T extends TimelineItem = TimelineItem> {

package/dist/{index-er1L8kkn.d.ts → index-DduoEosi.d.ts}

@@ -292,6 +292,12 @@ interface TimelineItem {
     end?: string | null;
     /** Longer text shown in the detail panel. */
     description?: string;
+    /**
+     * Up to three CSS colours the bar is painted with — e.g. an item's label
+     * colours. One fills solid; two or three split the bar into equal segments.
+     * Omitted or empty renders a neutral bar; colours past the third are ignored.
+     */
+    colors?: readonly string[];
 }
 
 interface TimelineCalendarProps<T extends TimelineItem = TimelineItem> {
@@ -300,29 +306,86 @@ interface TimelineCalendarProps<T extends TimelineItem = TimelineItem> {
     onSelect?: (item: T) => void;
     /** Bars shown per week before the remainder collapses to "+n more". */
     maxLanes?: number;
+    /** Ids to treat as the current selection — positions the event navigator's
+     *  ‹ n / N › on the matching event (e.g. the one open in the app's editor). */
+    selectedIds?: readonly string[];
+    /**
+     * Where the ‹ n / N › event navigator renders. Omit it for the built-in
+     * inline placement. Pass a host element (e.g. a slot in the app's own
+     * toolbar) to portal the navigator there instead — or `null` while that slot
+     * isn't mounted yet, which renders no navigator at all rather than falling
+     * back inline (avoids a flash of the inline one on first paint).
+     */
+    navigatorContainer?: HTMLElement | null;
+    /**
+     * Denominator shown by the navigator (`n / N`). Defaults to the number of
+     * dated items it can step through; a host may pass its full (filtered) item
+     * count instead so the figure matches the list it shows elsewhere, even when
+     * some of those items carry no date and so never appear here.
+     */
+    navigatorTotal?: number;
     /** Shown when nothing in `items` carries a date. */
     emptyState?: ReactNode;
     className?: string;
     /** Prefix for every `data-testid` this view emits. */
     testId?: string;
 }
-declare function TimelineCalendar<T extends TimelineItem = TimelineItem>({ items, onSelect, maxLanes, emptyState, className, testId, }: TimelineCalendarProps<T>): react.JSX.Element;
+declare function TimelineCalendar<T extends TimelineItem = TimelineItem>({ items, onSelect, selectedIds, maxLanes, navigatorContainer, navigatorTotal, emptyState, className, testId, }: TimelineCalendarProps<T>): react.JSX.Element;
 
 interface TimelineGanttProps<T extends TimelineItem = TimelineItem> {
     items: T[];
     /** The selected item, or null when the panel closes. */
     onSelect?: (item: T | null) => void;
+    /**
+     * Ids to render as selected — e.g. rows a user checked in another view.
+     * Their bar and label are highlighted so the selection carries across views;
+     * this does not open the detail panel (that stays driven by clicks here).
+     */
+    selectedIds?: readonly string[];
     /** Extra detail-panel content for the selected item — sources, links, actions. */
     renderDetail?: (item: T) => ReactNode;
     /** Width of the row-label gutter, in pixels. */
     labelWidth?: number;
+    /**
+     * When provided, the label gutter becomes user-resizable: a drag handle
+     * appears on its right edge and this fires with the new width (px) as the
+     * user drags. The caller owns the value (so it can persist it) and feeds it
+     * back via `labelWidth`.
+     */
+    onLabelWidthChange?: (width: number) => void;
+    /** Clamp for the resizable gutter, in pixels. */
+    minLabelWidth?: number;
+    maxLabelWidth?: number;
+    /**
+     * Controlled date-axis zoom (1 = fit). Provide BOTH `zoom` and `onZoomChange`
+     * to drive it from outside — e.g. a button in the app's own header — which also
+     * suppresses the chart's built-in corner control. Omit them to use the internal
+     * state and the corner control.
+     */
+    zoom?: number;
+    onZoomChange?: (zoom: number) => void;
+    /**
+     * Where the ‹ n / N › event navigator renders. Omit it for the built-in
+     * inline placement. Pass a host element (e.g. a slot in the app's own
+     * toolbar) to portal the navigator there instead — or `null` while that slot
+     * isn't mounted yet, which renders no navigator at all rather than falling
+     * back inline (avoids a flash of the inline one on first paint).
+     */
+    navigatorContainer?: HTMLElement | null;
+    /**
+     * Denominator shown by the navigator (`n / N`). Defaults to the number of
+     * dated items it can step through; a host may pass its full (filtered) item
+     * count instead so the figure matches the list it shows elsewhere, even when
+     * some of those items carry no date and so never appear here.
+     */
+    navigatorTotal?: number;
     /** Shown when nothing in `items` carries a usable date. */
     emptyMessage?: string;
     className?: string;
     /** Prefix for every `data-testid` this view emits. */
     testId?: string;
 }
-declare function TimelineGantt<T extends TimelineItem = TimelineItem>({ items, onSelect, renderDetail, labelWidth, emptyMessage, className, testId, }: TimelineGanttProps<T>): react.JSX.Element;
+declare function TimelineGantt<T extends TimelineItem = TimelineItem>({ items, onSelect, selectedIds, renderDetail, labelWidth, onLabelWidthChange, minLabelWidth, maxLabelWidth, zoom: zoomProp, onZoomChange, navigatorContainer, navigatorTotal, emptyMessage, className, testId, }: TimelineGanttProps<T>): react.JSX.Element;
 
 type TimelineViewMode = 'calendar' | 'gantt';
 interface TimelineProps<T extends TimelineItem = TimelineItem> {