@tensor_1/react 2.29.0 → 2.30.0

package/dist/index.d.cts

@@ -466,6 +466,178 @@ interface DateRangePickerProps {
 /** Controlled, two-month range picker using the UIx calendar language. */
 declare function DateRangePicker({ value, onChange, visibleMonth: controlledMonth, onVisibleMonthChange, months, min, max, isDateDisabled, locale, label, invalid, invalidMessage, disabled, className, labels: labelOverrides, }: DateRangePickerProps): react.JSX.Element;
 
+/**
+ * Pure model for `SchedulingTimeline` (HAR-1364; TENSOR C8): ticks on a time axis, where a
+ * bar sits on it, which bars in a lane overlap (and so stack and are flagged), and how a
+ * keyboard or pointer move snaps. Instants are ISO 8601 strings or epoch milliseconds; the
+ * axis is linear in real time, and only labels depend on the time zone.
+ */
+type TimelineScale = 'hour' | 'day' | 'week' | 'month';
+interface TimelineRange {
+    start: string;
+    end: string;
+}
+interface TimelineTick {
+    /** Epoch ms of the tick. */
+    at: number;
+    /** Position on the axis, 0–100. */
+    offset: number;
+    /** A major tick starts a larger unit (a new day on an hour axis, a new month on a day axis). */
+    major: boolean;
+}
+interface TimelineSpan {
+    id: string;
+    start: string;
+    end: string;
+}
+interface PlacedSpan<T extends TimelineSpan = TimelineSpan> {
+    item: T;
+    /** 0–100, clamped to the visible range. */
+    left: number;
+    width: number;
+    /** Starts before / ends after the visible range (draw a cut edge). */
+    clippedStart: boolean;
+    clippedEnd: boolean;
+    /** Sub-row inside the lane, so overlapping bars stack instead of covering each other. */
+    row: number;
+    /** Overlaps at least one other bar in the same lane. */
+    conflict: boolean;
+}
+declare const HOUR = 3600000;
+declare const DAY: number;
+/** The default move/resize step for a scale: 15 min on an hour axis, 1 h on a day axis, 1 day otherwise. */
+declare const defaultTimelineStep: (scale: TimelineScale) => number;
+/**
+ * Ticks for the range at the scale's unit (hour, day, week starting `weekStartsOn`, month),
+ * aligned to wall-clock boundaries in `timeZone`. Bounded to 500 ticks; a month axis over a
+ * year walks ~8,800 hours, so keep ranges to what fits on screen.
+ */
+declare function timelineTicks(range: TimelineRange, scale: TimelineScale, timeZone: string, weekStartsOn?: number): TimelineTick[];
+/** Position of one span on the axis, clamped to it; null when it is entirely outside. */
+declare function placeSpan(span: {
+    start: string;
+    end: string;
+}, range: TimelineRange): Omit<PlacedSpan, 'item' | 'row' | 'conflict'> | null;
+/**
+ * Places a lane's spans: sorted by start, each in the first sub-row where it does not overlap
+ * the previous bar, and flagged `conflict` when it overlaps any other span in the lane.
+ */
+declare function layoutLane<T extends TimelineSpan>(items: readonly T[], range: TimelineRange): PlacedSpan<T>[];
+/** Rounds a millisecond offset to the nearest step. */
+declare const snapToStep: (ms: number, step: number) => number;
+/** A span moved (both ends) or resized (end only) by `delta` ms, as ISO strings; never shorter than one step. */
+declare function shiftSpan(span: {
+    start: string;
+    end: string;
+}, delta: number, mode: 'move' | 'resize', step: number): {
+    start: string;
+    end: string;
+};
+/** Converts a horizontal pointer distance on a track of `trackWidth` px to snapped milliseconds. */
+declare function pixelsToMs(px: number, trackWidth: number, range: TimelineRange, step: number): number;
+
+interface SchedulingTimelineLane {
+    id: string;
+    label: ReactNode;
+    /** A quieter second line under the lane name (an owner, a count). */
+    meta?: ReactNode;
+}
+interface SchedulingTimelineItem {
+    id: string;
+    laneId: string;
+    title: string;
+    /** ISO 8601 instants. */
+    start: string;
+    end: string;
+    state?: SchedulingEntryState;
+    meta?: string;
+    /** `false` keeps this bar fixed even when `onMoveItem` is set. */
+    movable?: boolean;
+}
+type SchedulingTimelineOverlayKind = 'freeze' | 'maintenance' | 'blackout';
+interface SchedulingTimelineOverlay {
+    id: string;
+    label: string;
+    start: string;
+    end: string;
+    kind: SchedulingTimelineOverlayKind;
+    /** Only this lane; every lane when unset. */
+    laneId?: string;
+}
+interface SchedulingTimelineMarker {
+    id: string;
+    label: string;
+    /** ISO 8601 instant. */
+    at: string;
+    laneId?: string;
+}
+interface SchedulingTimelineLabels {
+    region: string;
+    lanes: string;
+    /** `{title}`, `{state}`, `{start}`, `{end}`, `{conflict}`. */
+    item: string;
+    conflict: string;
+    moveHint: string;
+    /** Announced after a move. `{title}`, `{start}`, `{end}`. */
+    moved: string;
+    /** Announced after a resize. `{title}`, `{end}`. */
+    resized: string;
+    loading: string;
+    retry: string;
+    empty: string;
+    /** Heading of the screen-reader list of windows and markers. */
+    windows: string;
+    now: string;
+    states: Record<SchedulingEntryState, string>;
+    overlays: Record<SchedulingTimelineOverlayKind, string>;
+}
+declare const DEFAULT_SCHEDULING_TIMELINE_LABELS: SchedulingTimelineLabels;
+interface SchedulingTimelineProps {
+    lanes: SchedulingTimelineLane[];
+    items: SchedulingTimelineItem[];
+    /** The visible window (ISO 8601 instants). */
+    range: TimelineRange;
+    /** Tick unit of the axis. Default `day`. */
+    scale?: TimelineScale;
+    /** IANA zone for tick boundaries and every printed time. */
+    timeZone: string;
+    locale?: string;
+    overlays?: SchedulingTimelineOverlay[];
+    markers?: SchedulingTimelineMarker[];
+    /** Draws a "now" line at this instant (pass the current time; the component keeps no clock). */
+    now?: string;
+    /** First day of a week tick (0 = Sunday). Default 1. */
+    weekStartsOn?: number;
+    /** Width of one tick, as a CSS length. Defaults: hour 3.5rem, day 7rem, week 6rem, month 8rem. */
+    tickWidth?: string;
+    /** Move/resize granularity in ms. Defaults: 15 min (hour), 1 h (day), 1 day (week, month). */
+    step?: number;
+    /** Tick label. Default: `Intl` in `locale` and `timeZone`. */
+    formatTick?: (at: Date, scale: TimelineScale) => string;
+    /** Start/end text in names and announcements. Default: `Intl` medium date + short time in `timeZone`. */
+    formatInstant?: (instant: string) => string;
+    /** Bar content. Default: the title. */
+    renderItem?: (item: SchedulingTimelineItem) => ReactNode;
+    onSelectItem?: (item: SchedulingTimelineItem) => void;
+    /** Makes bars draggable and keyboard-movable. Receives the snapped new start and end. */
+    onMoveItem?: (id: string, next: {
+        start: string;
+        end: string;
+    }) => void;
+    loading?: boolean;
+    error?: string;
+    onRetry?: () => void;
+    labels?: Partial<SchedulingTimelineLabels>;
+    className?: string;
+}
+/**
+ * Lanes of bars on a time axis (HAR-1364; TENSOR C8): change schedules, rollout Gantt rows,
+ * renewal markers. Overlapping bars in a lane stack and are hatched; freeze, maintenance and
+ * blackout windows are bands; with `onMoveItem`, bars move by drag or Shift+arrows and their
+ * end changes with Alt+Shift+arrows, snapped to `step`.
+ */
+declare function SchedulingTimeline({ lanes, items, range, scale, timeZone, locale, overlays, markers, now, weekStartsOn, tickWidth, step: stepProp, formatTick, formatInstant: formatInstantProp, renderItem, onSelectItem, onMoveItem, loading, error, onRetry, labels: labelOverrides, className, }: SchedulingTimelineProps): react.JSX.Element;
+
 /**
  * Kit chrome strings by component (HAR-1358; TENSOR C20, MOTUS executive summary #3).
  * Each entry overrides that component's English defaults for every instance below the
@@ -513,6 +685,7 @@ interface UixLabels {
     };
     schedulingCalendar?: Partial<SchedulingCalendarLabels>;
     dateRangePicker?: Partial<DateRangePickerLabels>;
+    schedulingTimeline?: Partial<SchedulingTimelineLabels>;
     /** Read by `useUixLabels()` callers; `Pagination` itself is server-safe and takes `labels`. */
     pagination?: Partial<PaginationLabels>;
     /** Read by `useUixLabels()` callers; `BulkBar` itself is server-safe and takes `label`. */
@@ -3472,4 +3645,4 @@ declare function hsvToHex(value: HsvColor): string;
 declare function contrastRatio(background: string, foreground: string): number | undefined;
 declare function meetsContrast(background: string, foreground: string, minimum?: number): boolean;
 
-export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarDay, type CalendarWeekday, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_STEP_STATE_LABELS, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, InfoTip, type InfoTipProps, Input, InputGroup, type InputGroupProps, type InputProps, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Kbd, KbdCombo, type KbdComboProps, type KbdPlatform, type KbdProps, Label, type LabelProps, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, LicensePositionBar, type LicensePositionBarProps, List, ListItem, type ListItemProps, type ListProps, LoadingState, type LoadingStateProps, Mark, type MarkProps, type MatchBulkResult, MatchReview, type MatchReviewAction, type MatchReviewCandidate, type MatchReviewField, type MatchReviewLabels, type MatchReviewProps, Menu, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, type MenuProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type NavFavouriteItem, NavFavourites, type NavFavouritesLabels, type NavFavouritesProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, NewsLead, type NewsLeadProps, NotFoundState, Note, type NoteProps, type NoteTone, NoticeQueue, type NoticeQueueProps, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, Placement, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, type PositionedRelationshipNode, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphArrow, type RelationshipGraphCluster, type RelationshipGraphEdge, type RelationshipGraphLabels, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type RoutedEdge, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderLabels, type RuleBuilderProps, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleValidationIssue, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingOverlayKind, type SearchSegment, SearchSuggest, type SearchSuggestAction, type SearchSuggestOption, type SearchSuggestProps, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectProps, type ShellNav, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonProps, type SortDir, type SortDirection, type SortKey, Spinner, type SpinnerProps, StarButton, type StarButtonProps, Stat, StatLine, type StatLineItem, type StatLineProps, type StatProps, type StatTrend, type StateVariant, StatusPill, type StatusPillProps, StatusRow, type StatusRowProps, Step, type StepProps, type StepState, type StepStateLabels, Steps, type StepsProps, SubNavItem, type SubNavItemProps, Switch, type SwitchProps, TOAST_LEAVE_MS, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, Textarea, type TextareaProps, Th, type ThProps, Timeline, TimelineItem, type TimelineItemProps, type TimelineProps, Toast, type ToastAction, type ToastApi, type ToastDismissReason, type ToastKind, type ToastOptions, type ToastPromiseMessages, type ToastProps, type ToastRecord, type ToastStore, type ToastTone, Toaster, type ToasterProps, ToggleRow, type ToggleRowProps, Tooltip, type TooltipProps, Tr, type TrProps, Tree, type TreeLike, type TreeNavAction, type TreeNodeData, type TreeNodeProps, type TreeProps, type UixLabels, UixLabelsProvider, type UixLabelsProviderProps, type UixLinkProps, type UixRenderLink, type UndoableToastOptions, type UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuColumnLabels, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, addCalendarDays, addCalendarMonths, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, enumerateDateSpan, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isRuleGroup, layeredNeighbor, layoutLayeredGraph, layoutRelationshipGraph, mapRuleGroup, matchFilter, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, parseDateValue, parseMetricValue, parseView, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, shouldVirtualize, startOfMonth, stepMetricValue, summarizeDiff, summarizeRule, toDateKey, toast, toggleId, togglePage, toggleSort, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan };
+export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, ButtonLink, type ButtonLinkProps, type ButtonProps, type ButtonSize, type ButtonVariant, type CalendarDay, type CalendarWeekday, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, Chip, ChipGroup, type ChipGroupProps, type ChipProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DAY, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_SCHEDULING_TIMELINE_LABELS, DEFAULT_STEP_STATE_LABELS, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, HOUR, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, InfoTip, type InfoTipProps, Input, InputGroup, type InputGroupProps, type InputProps, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Kbd, KbdCombo, type KbdComboProps, type KbdPlatform, type KbdProps, Label, type LabelProps, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, LicensePositionBar, type LicensePositionBarProps, List, ListItem, type ListItemProps, type ListProps, LoadingState, type LoadingStateProps, Mark, type MarkProps, type MatchBulkResult, MatchReview, type MatchReviewAction, type MatchReviewCandidate, type MatchReviewField, type MatchReviewLabels, type MatchReviewProps, Menu, MenuGroup, type MenuGroupProps, MenuItem, type MenuItemProps, type MenuProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type NavFavouriteItem, NavFavourites, type NavFavouritesLabels, type NavFavouritesProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, NewsLead, type NewsLeadProps, NotFoundState, Note, type NoteProps, type NoteTone, NoticeQueue, type NoticeQueueProps, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type PlacedSpan, Placement, Popconfirm, type PopconfirmProps, Popover, type PopoverProps, type PositionedRelationshipNode, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphArrow, type RelationshipGraphCluster, type RelationshipGraphEdge, type RelationshipGraphLabels, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type RoutedEdge, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderLabels, type RuleBuilderProps, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleValidationIssue, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingOverlayKind, SchedulingTimeline, type SchedulingTimelineItem, type SchedulingTimelineLabels, type SchedulingTimelineLane, type SchedulingTimelineMarker, type SchedulingTimelineOverlay, type SchedulingTimelineOverlayKind, type SchedulingTimelineProps, type SearchSegment, SearchSuggest, type SearchSuggestAction, type SearchSuggestOption, type SearchSuggestProps, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectProps, type ShellNav, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonProps, type SortDir, type SortDirection, type SortKey, Spinner, type SpinnerProps, StarButton, type StarButtonProps, Stat, StatLine, type StatLineItem, type StatLineProps, type StatProps, type StatTrend, type StateVariant, StatusPill, type StatusPillProps, StatusRow, type StatusRowProps, Step, type StepProps, type StepState, type StepStateLabels, Steps, type StepsProps, SubNavItem, type SubNavItemProps, Switch, type SwitchProps, TOAST_LEAVE_MS, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, Textarea, type TextareaProps, Th, type ThProps, Timeline, TimelineItem, type TimelineItemProps, type TimelineProps, type TimelineRange, type TimelineScale, type TimelineSpan, type TimelineTick, Toast, type ToastAction, type ToastApi, type ToastDismissReason, type ToastKind, type ToastOptions, type ToastPromiseMessages, type ToastProps, type ToastRecord, type ToastStore, type ToastTone, Toaster, type ToasterProps, ToggleRow, type ToggleRowProps, Tooltip, type TooltipProps, Tr, type TrProps, Tree, type TreeLike, type TreeNavAction, type TreeNodeData, type TreeNodeProps, type TreeProps, type UixLabels, UixLabelsProvider, type UixLabelsProviderProps, type UixLinkProps, type UixRenderLink, type UndoableToastOptions, type UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuColumnLabels, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, addCalendarDays, addCalendarMonths, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, defaultTimelineStep, enumerateDateSpan, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isRuleGroup, layeredNeighbor, layoutLane, layoutLayeredGraph, layoutRelationshipGraph, mapRuleGroup, matchFilter, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, parseDateValue, parseMetricValue, parseView, pixelsToMs, placeSpan, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, shiftSpan, shouldVirtualize, snapToStep, startOfMonth, stepMetricValue, summarizeDiff, summarizeRule, timelineTicks, toDateKey, toast, toggleId, togglePage, toggleSort, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan };

package/dist/index.d.ts

@@ -82,6 +82,8 @@ export { DEFAULT_RULE_BUILDER_LABELS, RuleActionDefinition, RuleBuilder, RuleBui
 export { RuleAction, RuleCondition, RuleDefinition, RuleGroup, RuleValidationIssue, appendRuleNode, findRuleNodeDepth, isRuleGroup, mapRuleGroup, moveRuleNode, removeRuleNode, ruleDepth, summarizeRule, validateRuleDefinition } from './rule-builder-model.js';
 export { BuilderCanvas, BuilderCanvasItem, BuilderCanvasLabels, BuilderCanvasProps, BuilderPaletteItem, DEFAULT_BUILDER_CANVAS_LABELS } from './components/BuilderCanvas.js';
 export { DEFAULT_SCHEDULING_CALENDAR_LABELS, SchedulingCalendar, SchedulingCalendarEntry, SchedulingCalendarLabels, SchedulingCalendarOverlay, SchedulingCalendarProps, SchedulingCalendarView, SchedulingDatePart, SchedulingEntryState, SchedulingOverlayKind } from './components/SchedulingCalendar.js';
+export { DEFAULT_SCHEDULING_TIMELINE_LABELS, SchedulingTimeline, SchedulingTimelineItem, SchedulingTimelineLabels, SchedulingTimelineLane, SchedulingTimelineMarker, SchedulingTimelineOverlay, SchedulingTimelineOverlayKind, SchedulingTimelineProps } from './components/SchedulingTimeline.js';
+export { DAY, HOUR, PlacedSpan, TimelineRange, TimelineScale, TimelineSpan, TimelineTick, defaultTimelineStep, layoutLane, pixelsToMs, placeSpan, shiftSpan, snapToStep, timelineTicks } from './scheduling-timeline-model.js';
 export { DEFAULT_DATE_RANGE_PICKER_LABELS, DateRangePicker, DateRangePickerLabels, DateRangePickerProps } from './components/DateRangePicker.js';
 export { CalendarDay, CalendarWeekday, DateRangeValue, ZonedDateSpan, addCalendarDays, addCalendarMonths, buildMonthGrid, enumerateDateSpan, isDateInRange, isDateUnavailable, selectRangeDate, startOfMonth, toDateKey, zonedDateKey, zonedDateSpan } from './calendar-model.js';
 export { DEFAULT_RELATIONSHIP_GRAPH_LABELS, RelationshipGraph, RelationshipGraphLabels, RelationshipGraphLegendItem, RelationshipGraphProps } from './components/RelationshipGraph.js';

package/dist/index.js

@@ -119,6 +119,18 @@ import {
 } from "./rule-builder-model.js";
 import { BuilderCanvas, DEFAULT_BUILDER_CANVAS_LABELS } from "./components/BuilderCanvas.js";
 import { DEFAULT_SCHEDULING_CALENDAR_LABELS, SchedulingCalendar } from "./components/SchedulingCalendar.js";
+import { DEFAULT_SCHEDULING_TIMELINE_LABELS, SchedulingTimeline } from "./components/SchedulingTimeline.js";
+import {
+  DAY,
+  HOUR,
+  defaultTimelineStep,
+  layoutLane,
+  pixelsToMs,
+  placeSpan,
+  shiftSpan,
+  snapToStep,
+  timelineTicks
+} from "./scheduling-timeline-model.js";
 import { DateRangePicker, DEFAULT_DATE_RANGE_PICKER_LABELS } from "./components/DateRangePicker.js";
 import {
   addCalendarDays,
@@ -179,6 +191,7 @@ export {
   ContentList,
   ContentListItem,
   CopyButton,
+  DAY,
   DEFAULT_BRAND_PROFILE_EDITOR_LABELS,
   DEFAULT_BUILDER_CANVAS_LABELS,
   DEFAULT_COLOR_PICKER_LABELS,
@@ -190,6 +203,7 @@ export {
   DEFAULT_RULE_BUILDER_LABELS,
   DEFAULT_SAVE_STATUS_LABELS,
   DEFAULT_SCHEDULING_CALENDAR_LABELS,
+  DEFAULT_SCHEDULING_TIMELINE_LABELS,
   DEFAULT_STEP_STATE_LABELS,
   DateRangePicker,
   DescriptionItem,
@@ -211,6 +225,7 @@ export {
   Flow,
   FlowNode,
   ForbiddenState,
+  HOUR,
   Highlighted,
   Inbox,
   InboxDetail,
@@ -268,6 +283,7 @@ export {
   SaveStatus,
   SavedViewMenu,
   SchedulingCalendar,
+  SchedulingTimeline,
   SearchSuggest,
   SectionHead,
   Segmented,
@@ -321,6 +337,7 @@ export {
   createToastApi,
   createToastStore,
   cx,
+  defaultTimelineStep,
   enumerateDateSpan,
   filterComboboxOptions,
   findRuleNodeDepth,
@@ -333,6 +350,7 @@ export {
   isDateUnavailable,
   isRuleGroup,
   layeredNeighbor,
+  layoutLane,
   layoutLayeredGraph,
   layoutRelationshipGraph,
   mapRuleGroup,
@@ -341,6 +359,8 @@ export {
   normalizeHex,
   parseDateValue,
   parseMetricValue,
+  pixelsToMs,
+  placeSpan,
   relationshipNeighbors,
   relativeTimeValue,
   removeRuleNode,
@@ -351,10 +371,13 @@ export {
   ruleDepth,
   searchSegments,
   selectRangeDate,
+  shiftSpan,
+  snapToStep,
   startOfMonth,
   stepMetricValue,
   summarizeDiff,
   summarizeRule,
+  timelineTicks,
   toDateKey,
   toast,
   traverseRelationshipNode,

package/dist/labels-context.d.ts

@@ -3,8 +3,10 @@ import { ReactNode } from 'react';
 import { PaginationLabels } from './components/Pagination.js';
 import { SchedulingCalendarLabels } from './components/SchedulingCalendar.js';
 import { DateRangePickerLabels } from './components/DateRangePicker.js';
+import { SchedulingTimelineLabels } from './components/SchedulingTimeline.js';
 import './link.js';
 import './calendar-model.js';
+import './scheduling-timeline-model.js';
 
 /**
  * Kit chrome strings by component (HAR-1358; TENSOR C20, MOTUS executive summary #3).
@@ -53,6 +55,7 @@ interface UixLabels {
     };
     schedulingCalendar?: Partial<SchedulingCalendarLabels>;
     dateRangePicker?: Partial<DateRangePickerLabels>;
+    schedulingTimeline?: Partial<SchedulingTimelineLabels>;
     /** Read by `useUixLabels()` callers; `Pagination` itself is server-safe and takes `labels`. */
     pagination?: Partial<PaginationLabels>;
     /** Read by `useUixLabels()` callers; `BulkBar` itself is server-safe and takes `label`. */

package/dist/scheduling-timeline-model.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Pure model for `SchedulingTimeline` (HAR-1364; TENSOR C8): ticks on a time axis, where a
+ * bar sits on it, which bars in a lane overlap (and so stack and are flagged), and how a
+ * keyboard or pointer move snaps. Instants are ISO 8601 strings or epoch milliseconds; the
+ * axis is linear in real time, and only labels depend on the time zone.
+ */
+type TimelineScale = 'hour' | 'day' | 'week' | 'month';
+interface TimelineRange {
+    start: string;
+    end: string;
+}
+interface TimelineTick {
+    /** Epoch ms of the tick. */
+    at: number;
+    /** Position on the axis, 0–100. */
+    offset: number;
+    /** A major tick starts a larger unit (a new day on an hour axis, a new month on a day axis). */
+    major: boolean;
+}
+interface TimelineSpan {
+    id: string;
+    start: string;
+    end: string;
+}
+interface PlacedSpan<T extends TimelineSpan = TimelineSpan> {
+    item: T;
+    /** 0–100, clamped to the visible range. */
+    left: number;
+    width: number;
+    /** Starts before / ends after the visible range (draw a cut edge). */
+    clippedStart: boolean;
+    clippedEnd: boolean;
+    /** Sub-row inside the lane, so overlapping bars stack instead of covering each other. */
+    row: number;
+    /** Overlaps at least one other bar in the same lane. */
+    conflict: boolean;
+}
+declare const HOUR = 3600000;
+declare const DAY: number;
+/** The default move/resize step for a scale: 15 min on an hour axis, 1 h on a day axis, 1 day otherwise. */
+declare const defaultTimelineStep: (scale: TimelineScale) => number;
+/**
+ * Ticks for the range at the scale's unit (hour, day, week starting `weekStartsOn`, month),
+ * aligned to wall-clock boundaries in `timeZone`. Bounded to 500 ticks; a month axis over a
+ * year walks ~8,800 hours, so keep ranges to what fits on screen.
+ */
+declare function timelineTicks(range: TimelineRange, scale: TimelineScale, timeZone: string, weekStartsOn?: number): TimelineTick[];
+/** Position of one span on the axis, clamped to it; null when it is entirely outside. */
+declare function placeSpan(span: {
+    start: string;
+    end: string;
+}, range: TimelineRange): Omit<PlacedSpan, 'item' | 'row' | 'conflict'> | null;
+/**
+ * Places a lane's spans: sorted by start, each in the first sub-row where it does not overlap
+ * the previous bar, and flagged `conflict` when it overlaps any other span in the lane.
+ */
+declare function layoutLane<T extends TimelineSpan>(items: readonly T[], range: TimelineRange): PlacedSpan<T>[];
+/** Rounds a millisecond offset to the nearest step. */
+declare const snapToStep: (ms: number, step: number) => number;
+/** A span moved (both ends) or resized (end only) by `delta` ms, as ISO strings; never shorter than one step. */
+declare function shiftSpan(span: {
+    start: string;
+    end: string;
+}, delta: number, mode: 'move' | 'resize', step: number): {
+    start: string;
+    end: string;
+};
+/** Converts a horizontal pointer distance on a track of `trackWidth` px to snapped milliseconds. */
+declare function pixelsToMs(px: number, trackWidth: number, range: TimelineRange, step: number): number;
+
+export { DAY, HOUR, type PlacedSpan, type TimelineRange, type TimelineScale, type TimelineSpan, type TimelineTick, defaultTimelineStep, layoutLane, pixelsToMs, placeSpan, shiftSpan, snapToStep, timelineTicks };

package/dist/scheduling-timeline-model.js

@@ -0,0 +1,108 @@
+const HOUR = 36e5;
+const DAY = 24 * HOUR;
+const toMs = (value) => {
+  const ms = typeof value === "number" ? value : Date.parse(value);
+  if (Number.isNaN(ms)) throw new TypeError(`Invalid instant: ${String(value)}`);
+  return ms;
+};
+const defaultTimelineStep = (scale) => scale === "hour" ? 15 * 6e4 : scale === "day" ? HOUR : DAY;
+function zonedParts(ms, timeZone) {
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone,
+    hourCycle: "h23",
+    year: "numeric",
+    month: "numeric",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    weekday: "short"
+  }).formatToParts(new Date(ms));
+  const get = (type) => parts.find((p) => p.type === type)?.value ?? "";
+  return { year: +get("year"), month: +get("month"), day: +get("day"), hour: +get("hour"), minute: +get("minute"), weekday: get("weekday") };
+}
+function timelineTicks(range, scale, timeZone, weekStartsOn = 1) {
+  const start = toMs(range.start);
+  const end = toMs(range.end);
+  if (end <= start) return [];
+  const span = end - start;
+  const ticks = [];
+  const weekdays = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+  const step = scale === "hour" ? 15 * 6e4 : HOUR;
+  let prev = zonedParts(start - step, timeZone);
+  for (let at = Math.ceil(start / step) * step; at <= end && ticks.length < 500; at += step) {
+    const p = zonedParts(at, timeZone);
+    const newHour = p.minute === 0 && (p.hour !== prev.hour || prev.minute !== 0);
+    const newDay = p.day !== prev.day && p.minute === 0;
+    const newMonth = newDay && p.day === 1;
+    const newWeek = newDay && weekdays.indexOf(p.weekday) === weekStartsOn;
+    const isTick = scale === "hour" ? newHour : scale === "day" ? newDay : scale === "week" ? newWeek : newMonth;
+    if (isTick) {
+      const major = scale === "hour" ? newDay : scale === "day" ? newWeek : scale === "week" ? newMonth : p.month === 1;
+      ticks.push({ at, offset: (at - start) / span * 100, major });
+    }
+    prev = p;
+  }
+  return ticks;
+}
+function placeSpan(span, range) {
+  const start = toMs(range.start);
+  const end = toMs(range.end);
+  const s = toMs(span.start);
+  const e = Math.max(toMs(span.end), s);
+  if (e < start || s > end || end <= start) return null;
+  const total = end - start;
+  const left = (Math.max(s, start) - start) / total * 100;
+  const right = (Math.min(e, end) - start) / total * 100;
+  return { left, width: Math.max(right - left, 0), clippedStart: s < start, clippedEnd: e > end };
+}
+function layoutLane(items, range) {
+  const sorted = [...items].sort((a, b) => toMs(a.start) - toMs(b.start) || toMs(a.end) - toMs(b.end));
+  const rowEnds = [];
+  const placed = [];
+  for (const item of sorted) {
+    const pos = placeSpan(item, range);
+    if (!pos) continue;
+    const s = toMs(item.start);
+    let row = rowEnds.findIndex((end) => end <= s);
+    if (row === -1) {
+      row = rowEnds.length;
+      rowEnds.push(0);
+    }
+    rowEnds[row] = Math.max(toMs(item.end), s);
+    placed.push({ item, ...pos, row, conflict: false });
+  }
+  for (let i = 0; i < placed.length; i++) {
+    for (let j = i + 1; j < placed.length; j++) {
+      const a = placed[i].item;
+      const b = placed[j].item;
+      if (toMs(b.start) >= toMs(a.end)) continue;
+      if (toMs(a.start) < toMs(b.end)) {
+        placed[i].conflict = true;
+        placed[j].conflict = true;
+      }
+    }
+  }
+  return placed;
+}
+const snapToStep = (ms, step) => Math.round(ms / step) * step;
+function shiftSpan(span, delta, mode, step) {
+  const s = toMs(span.start);
+  const e = toMs(span.end);
+  if (mode === "move") return { start: new Date(s + delta).toISOString(), end: new Date(e + delta).toISOString() };
+  return { start: new Date(s).toISOString(), end: new Date(Math.max(e + delta, s + step)).toISOString() };
+}
+function pixelsToMs(px, trackWidth, range, step) {
+  if (trackWidth <= 0) return 0;
+  return snapToStep(px / trackWidth * (toMs(range.end) - toMs(range.start)), step);
+}
+export {
+  DAY,
+  HOUR,
+  defaultTimelineStep,
+  layoutLane,
+  pixelsToMs,
+  placeSpan,
+  shiftSpan,
+  snapToStep,
+  timelineTicks
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tensor_1/react",
-  "version": "2.29.0",
+  "version": "2.30.0",
   "description": "Thin React wrappers over the UIx v2 CSS component library.",
   "license": "UNLICENSED",
   "type": "module",