@zendir/ui 0.1.14 → 0.1.15

package/dist/react/astro/UnifiedTimeline.d.ts

@@ -31,8 +31,8 @@ export interface TimelineEvent {
     /** Custom metadata */
     metadata?: Record<string, unknown>;
     /** Secondary accent color for team/category identification (CSS color string).
-     *  Rendered as a top stripe (list & Gantt views) or outer ring (scatter view)
-     *  alongside the primary status color — does NOT override status indicators. */
+     *  List: thin top stripe. Chart/Gantt: optional thin top stripe only; status is shown via Astro shape + hover, not a top line.
+     *  Scatter: outer ring around the dot. Does NOT override status coloring. */
     color?: string;
 }
 export interface TimelineTrackDef {
@@ -45,13 +45,21 @@ export interface TimelineTrackDef {
 }
 export type TimeFormat = 'relative' | 'absolute' | 'utc';
 export interface TimelineFilter {
-    /** Filter by track IDs */
+    /** Filter by track IDs (empty / omitted = all tracks) */
     tracks?: string[];
-    /** Filter by status */
+    /** Filter by display status (multi-select; empty / omitted = all) */
     status?: TimelineEvent['status'][];
-    /** Search query */
+    /** Case-insensitive match on title, subtitle, badge, track, argument values */
     search?: string;
+    /** Duration shape: point (no end or zero length), range (has end after start), all */
+    eventShape?: 'all' | 'point' | 'range';
+    /** Only events with a team/category accent (`event.color`) */
+    teamColoredOnly?: boolean;
 }
+/** Display status used for filtering and markers (badgeVariant overrides raw status when set). */
+export declare function getTimelineEventDisplayStatus(event: TimelineEvent): TimelineEvent['status'];
+export declare function isTimelineFilterActive(filter: TimelineFilter): boolean;
+export declare function matchesTimelineFilter(event: TimelineEvent, filter: TimelineFilter): boolean;
 export interface UnifiedTimelineProps {
     /** Timeline title */
     title?: string;
@@ -85,11 +93,15 @@ export interface UnifiedTimelineProps {
     zoomable?: boolean;
     /** Initial zoom level (1 = 100%) */
     initialZoom?: number;
-    /** Show filter controls */
+    /** Show advanced filter & search toolbar (enable/disable for end users) */
     showFilters?: boolean;
+    /** Collapsed by default; set true to start with filters expanded */
+    filtersDefaultExpanded?: boolean;
+    /** When any filter is active, hide chart/scatter track rows that have no matching events */
+    hideEmptyTracksWhenFiltered?: boolean;
     /** Controlled filter state */
     filter?: TimelineFilter;
-    /** Filter change handler */
+    /** Filter change handler (receives normalized filter object) */
     onFilterChange?: (filter: TimelineFilter) => void;
     /** Show event count badge */
     showCount?: boolean;