@tensor_1/react 2.32.0 → 2.33.0

package/dist/index.d.cts

@@ -570,8 +570,117 @@ declare function schedulingGridDays(anchorDate: string, view: 'month' | 'week',
  * (never a UTC date). `days` are the grid's date keys, a whole number of weeks.
  */
 declare function layoutMonthSpans(spans: readonly MonthSpanInput[], days: readonly string[], options: LayoutMonthSpansOptions): MonthSpanLayout;
+/** How far past its first local midnight an entry may run and still be drawn in the grid (operator decision E12). */
+declare const TOP_LANE_CROSS_MIDNIGHT_MINUTES = 360;
+interface TimeGridEntryInput {
+    id: string;
+    /** Half-open `[start, end)` instants (ISO 8601, epoch ms or Date). */
+    start: string | number | Date;
+    end: string | number | Date;
+    /** An entry with no time of day: always drawn in the top lane. */
+    allDay?: boolean;
+}
+/**
+ * Whether an entry is drawn in the top lane of the time grid instead of in the day columns:
+ * it is all-day, it is longer than one day (it ends after the same wall-clock time on the
+ * next day), or it runs more than `crossMidnightMinutes` past its first local midnight. A
+ * shorter midnight-crosser stays in the grid as a start segment and a continuation segment.
+ */
+declare function placesInTopLane(entry: Pick<TimeGridEntryInput, 'start' | 'end' | 'allDay'>, timeZone: string, options?: {
+    crossMidnightMinutes?: number;
+}): boolean;
+/** Which part of an entry a grid segment is: all of it, its first day, or the rest on the next day. */
+type TimeGridPart = 'whole' | 'start' | 'continuation';
+interface TimeGridSegment {
+    id: string;
+    part: TimeGridPart;
+    /** The segment, clipped to the day (epoch ms). */
+    start: number;
+    end: number;
+    /** Real hours from the start of the day to the segment. Multiply by the hour height. */
+    offsetHours: number;
+    /** The length of the segment in real hours. */
+    lengthHours: number;
+    /** 0-based lane inside its overlap cluster. */
+    lane: number;
+    /** Lanes its cluster uses: the segment is this fraction of the column wide. */
+    laneCount: number;
+}
+interface TimeGridDayLayout {
+    date: string;
+    /** The first instant of the day (epoch ms) and its length in real hours. */
+    dayStart: number;
+    dayHours: number;
+    /** One per entry part that got a lane, by start. */
+    segments: TimeGridSegment[];
+    /** Entries on this day that got no lane, by start. */
+    hidden: string[];
+}
+/**
+ * Lays one day column out: every entry that is not in the top lane and touches the day, clipped
+ * to it and packed into at most `maxLanes` lanes with `packLanes`. An entry that crosses
+ * midnight gives a `'start'` segment on its first day and a `'continuation'` on the next.
+ */
+declare function layoutTimeGridDay(entries: readonly TimeGridEntryInput[], date: string, timeZone: string, options?: {
+    maxLanes?: number;
+    crossMidnightMinutes?: number;
+}): TimeGridDayLayout;
+interface PlacedDaySpan {
+    id: string;
+    lane: number;
+    /** First and last column (inclusive) of `days` the span covers. */
+    startCol: number;
+    endCol: number;
+    continuesBefore: boolean;
+    continuesAfter: boolean;
+}
+interface DaySpanLayout {
+    placed: PlacedDaySpan[];
+    /** Ids that got no lane, in input order. */
+    hidden: string[];
+    /** The first day a hidden span covers, when there is one. */
+    firstHiddenDay?: string;
+}
+/**
+ * Places spans over one row of consecutive `days` (a week, or the single day of the Day
+ * view), in the order given, in at most `laneCap` lanes. Day membership is the end-exclusive
+ * zoned span. The time grid uses it for its top lane and its window strip.
+ */
+declare function layoutDaySpans(spans: readonly MonthSpanInput[], days: readonly string[], options: {
+    timeZone: string;
+    laneCap?: number;
+}): DaySpanLayout;
+/** A move the user asks for. The component never applies it: the consumer decides. */
+interface MoveProposal {
+    /** ISO 8601 instants of the proposed window. */
+    start: string;
+    end: string;
+    /** `'gap_forward'` when the wall-clock time asked for does not exist that day and moved past the gap. */
+    adjusted: 'gap_forward' | null;
+}
+/**
+ * The window `[start, end)` moved by `minutes` of real time and then by `days` calendar days.
+ * A day move keeps the wall-clock start and end (`addZonedDays`), whatever the length of the
+ * days in between. Compute it from the original window every time, so that a time falling in
+ * a clock-change gap moves forward once, never twice. When a clock change on the target day
+ * would put the wall-clock end at or before the start (a window that sits on the skipped or
+ * repeated hour), the end keeps the real length of the window instead.
+ */
+declare function proposeMove(span: {
+    start: string | number | Date;
+    end: string | number | Date;
+}, delta: {
+    days?: number;
+    minutes?: number;
+}, timeZone: string): MoveProposal;
+
+interface TimeGridEntryContext {
+    /** Whole text lines that fit in the item: 0 shows the markers only. */
+    availableLines: number;
+}
 
-type SchedulingCalendarView = 'month' | 'week' | 'agenda';
+/** `day` is one column of the time grid. `week` is the time grid when `timeGrid` is set, else seven day cells. */
+type SchedulingCalendarView = 'month' | 'week' | 'day' | 'agenda';
 /**
  * @deprecated Use `band`, `status` and `markers` on the entry: they carry no product
  * vocabulary and the consumer supplies every word. The values keep working in 2.x.
@@ -596,9 +705,10 @@ type SchedulingOverlayPattern = 'diagonal' | 'cross' | 'dotted' | 'solid';
  * Which date text a `formatDate` call is for (TENSOR B1/C9, HAR-1347):
  * `day` names one day (each day cell's accessible name, the week-range title);
  * `weekday` is the short column header (the date is any day of that weekday);
- * `month` is the month-view title (the date is the first of the month).
+ * `month` is the month-view title (the date is the first of the month);
+ * `column` heads one day column of the time grid (weekday and date, e.g. "Wed 07.10").
  */
-type SchedulingDatePart = 'day' | 'weekday' | 'month';
+type SchedulingDatePart = 'day' | 'weekday' | 'month' | 'column';
 /** A shape or icon with text. The text is always in the accessible name; a marker never relies on colour. */
 interface SchedulingMarker {
     id: string;
@@ -620,6 +730,10 @@ interface SchedulingCalendarEntry {
     markers?: SchedulingMarker[];
     /** The complete accessible name, built by the consumer from its own words. Replaces `labels.entry`. */
     accessibleName?: string;
+    /** No time of day. In the time grid the entry is drawn in the top lane. */
+    allDay?: boolean;
+    /** `false` keeps this entry where it is when the grid allows moves (`canMove`). */
+    movable?: boolean;
 }
 interface SchedulingCalendarOverlay {
     id: string;
@@ -675,9 +789,12 @@ interface SchedulingCalendarLabels {
     /** Also names the agenda's step, which moves by a week. */
     previousWeek?: string;
     nextWeek?: string;
+    previousDay?: string;
+    nextDay?: string;
     viewGroup: string;
     viewMonth: string;
     viewWeek: string;
+    viewDay?: string;
     viewAgenda: string;
     loading: string;
     retry: string;
@@ -704,6 +821,26 @@ interface SchedulingCalendarLabels {
     states: Record<SchedulingEntryState, string>;
     /** The words for `status`, used in the default accessible name and the agenda. */
     statuses?: Partial<Record<SchedulingStatus, string>>;
+    /** The header of the hour axis: it names the display zone. `{timeZone}` placeholder. */
+    timeZone?: string;
+    /** Names the strip of windows above the time grid. */
+    windows?: string;
+    /** "+N windows" when the strip has more windows than lanes. `{count}` placeholder. */
+    moreWindows?: string;
+    /** Accessible name of that control. `{count}` and `{date}` (the first day with a hidden window). */
+    moreWindowsLabel?: string;
+    /** Names the lane above the hours that holds all-day and long entries. */
+    topLane?: string;
+    /** The cue on the second-day part of an entry that crosses midnight. `{time}` is its start. */
+    continuesFrom?: string;
+    /** Read after an item's name when it can be moved. */
+    moveHint?: string;
+    /** Announced for a pending move. `{start}` and `{end}` placeholders. */
+    moveProposed?: string;
+    /** Announced when a pending move is dropped. */
+    moveCancelled?: string;
+    /** Announced when the time asked for does not exist that day. `{time}` is the time used instead. */
+    gapForward?: string;
 }
 declare const DEFAULT_SCHEDULING_CALENDAR_LABELS: SchedulingCalendarLabels;
 interface SchedulingCalendarProps {
@@ -724,8 +861,12 @@ interface SchedulingCalendarProps {
     /** Called by a click or Enter on a window span. */
     onSelectOverlay?: (overlay: SchedulingCalendarOverlay) => void;
     filter?: (entry: SchedulingCalendarEntry) => boolean;
-    /** Replaces a chip's content. The default is the start time in `timeZone` (24 h) and the title. */
-    renderEntry?: (entry: SchedulingCalendarEntry) => ReactNode;
+    /**
+     * Replaces a chip's content. The default is the start time in `timeZone` (24 h) and the title.
+     * In the time grid the second argument says how many text lines fit in the item (0: show the
+     * markers only); elsewhere it is not passed.
+     */
+    renderEntry?: (entry: SchedulingCalendarEntry, context?: TimeGridEntryContext) => ReactNode;
     locale?: string;
     /** First column of the month and week grids: 0 = Sunday … 6 = Saturday. Defaults to 1 (Monday). */
     weekStartsOn?: CalendarWeekday;
@@ -797,6 +938,32 @@ interface SchedulingCalendarProps {
     emptyNote?: ReactNode;
     /** Called by a click or Enter on a day number. */
     onSelectDate?: (date: string) => void;
+    /**
+     * Draws `view="week"` as a time grid: seven day columns on an hour axis. `view="day"` is
+     * always a time grid. Default `false`: the week stays seven day cells.
+     */
+    timeGrid?: boolean;
+    /** An instant (ISO 8601). The time grid draws one line at it, in the column of its day. The component keeps no clock. */
+    now?: string;
+    /**
+     * Lets the user ask for a move in the time grid (drag, or Shift and an arrow key, then
+     * Enter). Without it, or without `onProposeMove`, items have no move affordance at all.
+     */
+    canMove?: boolean;
+    /** Minutes a move snaps to. Default 15. */
+    step?: number;
+    /**
+     * Called once per finished gesture with the window the user asks for. The calendar never
+     * moves the item: it draws entries where the props say, so an entry whose props do not
+     * change is back where it was. Return a promise to keep the outline until it settles.
+     */
+    onProposeMove?: (id: string, proposal: MoveProposal) => void | Promise<unknown>;
+    /** An entry running more than this many minutes past its first local midnight goes to the top lane. Default 360. */
+    topLaneCrossMidnightMinutes?: number;
+    /** Rows of the top lane of the time grid. Default 3. */
+    topLaneCap?: number;
+    /** Lanes side by side in one day column of the time grid, at most. Fewer are used when the column is narrow. Default 4. */
+    maxLanes?: number;
     loading?: boolean;
     error?: string;
     onRetry?: () => void;
@@ -804,7 +971,7 @@ interface SchedulingCalendarProps {
     labels?: Partial<SchedulingCalendarLabels>;
 }
 /** Month/week/agenda calendar for UTC ranges rendered in an explicit IANA time zone. */
-declare function SchedulingCalendar({ entries, anchorDate, timeZone, view: controlledView, onViewChange, onAnchorDateChange, onSelectEntry, overlays, onSelectOverlay, filter, renderEntry, locale, weekStartsOn, formatDate, formatInstant: formatInstantProp, maxEntriesPerDay, onShowMore, renderDayBadge, days: dayInfo, dayEntries, spanLayout, windowLaneCap, spanLaneCap, legend, legendCaption, showHeader, notice, emptyNote, onSelectDate, loading, error, onRetry, className, labels: labelOverrides, }: SchedulingCalendarProps): react.JSX.Element;
+declare function SchedulingCalendar({ entries, anchorDate, timeZone, view: controlledView, onViewChange, onAnchorDateChange, onSelectEntry, overlays, onSelectOverlay, filter, renderEntry, locale, weekStartsOn, formatDate, formatInstant: formatInstantProp, maxEntriesPerDay, onShowMore, renderDayBadge, days: dayInfo, dayEntries, spanLayout, windowLaneCap, spanLaneCap, legend, legendCaption, showHeader, notice, emptyNote, onSelectDate, timeGrid, now, canMove, step, onProposeMove, topLaneCrossMidnightMinutes, topLaneCap, maxLanes, loading, error, onRetry, className, labels: labelOverrides, }: SchedulingCalendarProps): react.JSX.Element;
 
 /**
  * Every word the picker renders or announces (TENSOR RX-125, UIX-13). `{start}` and
@@ -5089,4 +5256,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, Attachment, type AttachmentLabels, AttachmentList, type AttachmentListProps, type AttachmentProps, 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_ATTACHMENT_LABELS, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_RULE_SUMMARY_WORDS, DEFAULT_RULE_VALIDATION_MESSAGES, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_SCHEDULING_TIMELINE_LABELS, DEFAULT_STEP_STATE_LABELS, DEFAULT_TEXT_DIFF_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, 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, EntityPicker, type EntityPickerLabels, type EntityPickerProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FileRejection, type FileRejectionReason, type FileSizeFormatter, type FileSizeOptions, FileUpload, type FileUploadItem, type FileUploadLabels, type FileUploadProps, type FileUploadStatus, type FilterChoice, FilterEditor, type FilterEditorLabels, type FilterEditorProps, type FilterField, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, type FilterPreset, type FilterSummaryLabels, type FilterValue, type FilterValueKind, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, HOUR, Heartbeat, type HeartbeatProps, type HeartbeatState, 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 LaneCluster, type LaneInterval, type LanePlacement, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, type LayoutMonthSpansOptions, LicensePositionBar, type LicensePositionBarProps, Lightbox, type LightboxItem, type LightboxLabels, type LightboxProps, List, ListItem, type ListItemProps, type ListProps, LiveIndicator, type LiveIndicatorProps, 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 MenuItemAttributes, MenuItemCheckbox, type MenuItemCheckboxProps, type MenuItemProps, MenuItemRadio, type MenuItemRadioProps, type MenuProps, MenuRadioGroup, type MenuRadioGroupProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, NUMBER_FILTER_OPERATORS, 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, type NumberFilterOperator, type PackLanesOptions, type PackedLanes, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillSize, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type PlacedMonthSpan, 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 RuleCheck, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleSummaryWords, type RuleValidationIssue, type RuleValidationOptions, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, type SchedulingBand, SchedulingCalendar, type SchedulingCalendarDay, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingLegendItem, type SchedulingMarker, type SchedulingMarkerEmphasis, type SchedulingOverlayKind, type SchedulingOverlayPattern, type SchedulingStatus, 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 SelectGroup, type SelectLabels, type SelectOption, 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, type SummarizeFilterOptions, Switch, type SwitchProps, TEXT_FILTER_OPERATORS, TOAST_LEAVE_MS, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, TextDiff, type TextDiffGranularity, type TextDiffLabels, type TextDiffLine, type TextDiffOp, type TextDiffOptions, type TextDiffProps, type TextDiffResult, type TextDiffRow, type TextDiffSegment, type TextFilterOperator, 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, type ZonedDayBounds, type ZonedDayShift, type ZonedDaySpan, type ZonedHourSlot, addCalendarDays, addCalendarMonths, addZonedDays, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, cachedDateTimeFormat, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, dashboardGridClassName, dashboardGridItemClassName, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, itemDaySpan, layeredNeighbor, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateValue, parseMetricValue, parseView, partitionFiles, pixelsToMs, placeSpan, rankOverflow, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, schedulingGridDays, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, setRuleCombinator, shiftSpan, shouldVirtualize, snapToStep, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timelineTicks, toDateKey, toast, toggleId, togglePage, toggleSort, tokenizeText, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan, zonedDayBounds, zonedDaySpan, zonedHourSlots, zonedTimeOfDay };
+export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Attachment, type AttachmentLabels, AttachmentList, type AttachmentListProps, type AttachmentProps, 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_ATTACHMENT_LABELS, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_RULE_SUMMARY_WORDS, DEFAULT_RULE_VALIDATION_MESSAGES, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DEFAULT_SCHEDULING_TIMELINE_LABELS, DEFAULT_STEP_STATE_LABELS, DEFAULT_TEXT_DIFF_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, type DaySpanLayout, 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, EntityPicker, type EntityPickerLabels, type EntityPickerProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FileRejection, type FileRejectionReason, type FileSizeFormatter, type FileSizeOptions, FileUpload, type FileUploadItem, type FileUploadLabels, type FileUploadProps, type FileUploadStatus, type FilterChoice, FilterEditor, type FilterEditorLabels, type FilterEditorProps, type FilterField, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, type FilterPreset, type FilterSummaryLabels, type FilterValue, type FilterValueKind, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, HOUR, Heartbeat, type HeartbeatProps, type HeartbeatState, 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 LaneCluster, type LaneInterval, type LanePlacement, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, type LayoutMonthSpansOptions, LicensePositionBar, type LicensePositionBarProps, Lightbox, type LightboxItem, type LightboxLabels, type LightboxProps, List, ListItem, type ListItemProps, type ListProps, LiveIndicator, type LiveIndicatorProps, 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 MenuItemAttributes, MenuItemCheckbox, type MenuItemCheckboxProps, type MenuItemProps, MenuItemRadio, type MenuItemRadioProps, type MenuProps, MenuRadioGroup, type MenuRadioGroupProps, MenuSeparator, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, type MoveProposal, NUMBER_FILTER_OPERATORS, 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, type NumberFilterOperator, type PackLanesOptions, type PackedLanes, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillSize, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type PlacedDaySpan, type PlacedMonthSpan, 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 RuleCheck, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleSummaryWords, type RuleValidationIssue, type RuleValidationOptions, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, type SchedulingBand, SchedulingCalendar, type SchedulingCalendarDay, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingLegendItem, type SchedulingMarker, type SchedulingMarkerEmphasis, type SchedulingOverlayKind, type SchedulingOverlayPattern, type SchedulingStatus, 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 SelectGroup, type SelectLabels, type SelectOption, 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, type SummarizeFilterOptions, Switch, type SwitchProps, TEXT_FILTER_OPERATORS, TOAST_LEAVE_MS, TOP_LANE_CROSS_MIDNIGHT_MINUTES, Tab, TabPanel, type TabPanelProps, type TabProps, Table, type TableDensity, type TableProps, TableWrap, type TableWrapProps, Tabs, type TabsProps, Td, type TdProps, TextDiff, type TextDiffGranularity, type TextDiffLabels, type TextDiffLine, type TextDiffOp, type TextDiffOptions, type TextDiffProps, type TextDiffResult, type TextDiffRow, type TextDiffSegment, type TextFilterOperator, Textarea, type TextareaProps, Th, type ThProps, type TimeGridDayLayout, type TimeGridEntryContext, type TimeGridEntryInput, type TimeGridPart, type TimeGridSegment, 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, type ZonedDayBounds, type ZonedDayShift, type ZonedDaySpan, type ZonedHourSlot, addCalendarDays, addCalendarMonths, addZonedDays, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, cachedDateTimeFormat, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, createToastApi, createToastStore, cx, dashboardGridClassName, dashboardGridItemClassName, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, itemDaySpan, layeredNeighbor, layoutDaySpans, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, layoutTimeGridDay, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateValue, parseMetricValue, parseView, partitionFiles, pixelsToMs, placeSpan, placesInTopLane, proposeMove, rankOverflow, relationshipNeighbors, relativeTimeValue, removeRuleNode, renderPlainLink, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, schedulingGridDays, searchRows, searchSegments, selectAllState, selectRangeDate, serializeView, setRuleCombinator, shiftSpan, shouldVirtualize, snapToStep, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timelineTicks, toDateKey, toast, toggleId, togglePage, toggleSort, tokenizeText, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useUixLabels, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan, zonedDayBounds, zonedDaySpan, zonedHourSlots, zonedTimeOfDay };

package/dist/index.d.ts

@@ -90,8 +90,8 @@ export { JsonPrimitive, JsonValue } from './json-value.js';
 export { DEFAULT_RULE_BUILDER_LABELS, RuleActionDefinition, RuleBuilder, RuleBuilderLabels, RuleBuilderProps, RuleFieldDefinition, RuleOperatorDefinition, RuleValueEditorProps } from './components/RuleBuilder.js';
 export { DEFAULT_RULE_SUMMARY_WORDS, DEFAULT_RULE_VALIDATION_MESSAGES, RuleAction, RuleCheck, RuleCondition, RuleDefinition, RuleGroup, RuleSummaryWords, RuleValidationIssue, RuleValidationOptions, appendRuleNode, findRuleNodeDepth, isRuleGroup, mapRuleGroup, moveRuleNode, removeRuleNode, ruleDepth, setRuleCombinator, 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, SchedulingBand, SchedulingCalendar, SchedulingCalendarDay, SchedulingCalendarEntry, SchedulingCalendarLabels, SchedulingCalendarOverlay, SchedulingCalendarProps, SchedulingCalendarView, SchedulingDatePart, SchedulingEntryState, SchedulingLegendItem, SchedulingMarker, SchedulingMarkerEmphasis, SchedulingOverlayKind, SchedulingOverlayPattern, SchedulingStatus } from './components/SchedulingCalendar.js';
-export { LayoutMonthSpansOptions, MonthSpanGroup, MonthSpanInput, MonthSpanLayout, PlacedMonthSpan, itemDaySpan, layoutMonthSpans, schedulingGridDays } from './scheduling-calendar-model.js';
+export { D as DEFAULT_SCHEDULING_CALENDAR_LABELS, S as SchedulingBand, a as SchedulingCalendar, b as SchedulingCalendarDay, c as SchedulingCalendarEntry, d as SchedulingCalendarLabels, e as SchedulingCalendarOverlay, f as SchedulingCalendarProps, g as SchedulingCalendarView, h as SchedulingDatePart, i as SchedulingEntryState, j as SchedulingLegendItem, k as SchedulingMarker, l as SchedulingMarkerEmphasis, m as SchedulingOverlayKind, n as SchedulingOverlayPattern, o as SchedulingStatus, T as TimeGridEntryContext } from './SchedulingCalendar-C4XVbqZr.js';
+export { DaySpanLayout, LayoutMonthSpansOptions, MonthSpanGroup, MonthSpanInput, MonthSpanLayout, MoveProposal, PlacedDaySpan, PlacedMonthSpan, TOP_LANE_CROSS_MIDNIGHT_MINUTES, TimeGridDayLayout, TimeGridEntryInput, TimeGridPart, TimeGridSegment, itemDaySpan, layoutDaySpans, layoutMonthSpans, layoutTimeGridDay, placesInTopLane, proposeMove, schedulingGridDays } from './scheduling-calendar-model.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';

package/dist/index.js

@@ -139,7 +139,16 @@ 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 { itemDaySpan, layoutMonthSpans, schedulingGridDays } from "./scheduling-calendar-model.js";
+import {
+  TOP_LANE_CROSS_MIDNIGHT_MINUTES,
+  itemDaySpan,
+  layoutDaySpans,
+  layoutMonthSpans,
+  layoutTimeGridDay,
+  placesInTopLane,
+  proposeMove,
+  schedulingGridDays
+} from "./scheduling-calendar-model.js";
 import { DEFAULT_SCHEDULING_TIMELINE_LABELS, SchedulingTimeline } from "./components/SchedulingTimeline.js";
 import {
   DAY,
@@ -359,6 +368,7 @@ export {
   Switch,
   TEXT_FILTER_OPERATORS,
   TOAST_LEAVE_MS,
+  TOP_LANE_CROSS_MIDNIGHT_MINUTES,
   Tab,
   TabPanel,
   Table,
@@ -420,10 +430,12 @@ export {
   isRuleGroup,
   itemDaySpan,
   layeredNeighbor,
+  layoutDaySpans,
   layoutLane,
   layoutLayeredGraph,
   layoutMonthSpans,
   layoutRelationshipGraph,
+  layoutTimeGridDay,
   mapRuleGroup,
   matchFilterPreset,
   meetsContrast,
@@ -435,6 +447,8 @@ export {
   partitionFiles,
   pixelsToMs,
   placeSpan,
+  placesInTopLane,
+  proposeMove,
   rankOverflow,
   relationshipNeighbors,
   relativeTimeValue,

package/dist/labels-context.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { PaginationLabels } from './components/Pagination.js';
-import { SchedulingCalendarLabels } from './components/SchedulingCalendar.js';
+import { d as SchedulingCalendarLabels } from './SchedulingCalendar-C4XVbqZr.js';
 import { DateRangePickerLabels } from './components/DateRangePicker.js';
 import { SchedulingTimelineLabels } from './components/SchedulingTimeline.js';
 import { TextDiffLabels } from './components/TextDiff.js';

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

@@ -62,5 +62,108 @@ declare function schedulingGridDays(anchorDate: string, view: 'month' | 'week',
  * (never a UTC date). `days` are the grid's date keys, a whole number of weeks.
  */
 declare function layoutMonthSpans(spans: readonly MonthSpanInput[], days: readonly string[], options: LayoutMonthSpansOptions): MonthSpanLayout;
+/** How far past its first local midnight an entry may run and still be drawn in the grid (operator decision E12). */
+declare const TOP_LANE_CROSS_MIDNIGHT_MINUTES = 360;
+interface TimeGridEntryInput {
+    id: string;
+    /** Half-open `[start, end)` instants (ISO 8601, epoch ms or Date). */
+    start: string | number | Date;
+    end: string | number | Date;
+    /** An entry with no time of day: always drawn in the top lane. */
+    allDay?: boolean;
+}
+/**
+ * Whether an entry is drawn in the top lane of the time grid instead of in the day columns:
+ * it is all-day, it is longer than one day (it ends after the same wall-clock time on the
+ * next day), or it runs more than `crossMidnightMinutes` past its first local midnight. A
+ * shorter midnight-crosser stays in the grid as a start segment and a continuation segment.
+ */
+declare function placesInTopLane(entry: Pick<TimeGridEntryInput, 'start' | 'end' | 'allDay'>, timeZone: string, options?: {
+    crossMidnightMinutes?: number;
+}): boolean;
+/** Which part of an entry a grid segment is: all of it, its first day, or the rest on the next day. */
+type TimeGridPart = 'whole' | 'start' | 'continuation';
+interface TimeGridSegment {
+    id: string;
+    part: TimeGridPart;
+    /** The segment, clipped to the day (epoch ms). */
+    start: number;
+    end: number;
+    /** Real hours from the start of the day to the segment. Multiply by the hour height. */
+    offsetHours: number;
+    /** The length of the segment in real hours. */
+    lengthHours: number;
+    /** 0-based lane inside its overlap cluster. */
+    lane: number;
+    /** Lanes its cluster uses: the segment is this fraction of the column wide. */
+    laneCount: number;
+}
+interface TimeGridDayLayout {
+    date: string;
+    /** The first instant of the day (epoch ms) and its length in real hours. */
+    dayStart: number;
+    dayHours: number;
+    /** One per entry part that got a lane, by start. */
+    segments: TimeGridSegment[];
+    /** Entries on this day that got no lane, by start. */
+    hidden: string[];
+}
+/**
+ * Lays one day column out: every entry that is not in the top lane and touches the day, clipped
+ * to it and packed into at most `maxLanes` lanes with `packLanes`. An entry that crosses
+ * midnight gives a `'start'` segment on its first day and a `'continuation'` on the next.
+ */
+declare function layoutTimeGridDay(entries: readonly TimeGridEntryInput[], date: string, timeZone: string, options?: {
+    maxLanes?: number;
+    crossMidnightMinutes?: number;
+}): TimeGridDayLayout;
+interface PlacedDaySpan {
+    id: string;
+    lane: number;
+    /** First and last column (inclusive) of `days` the span covers. */
+    startCol: number;
+    endCol: number;
+    continuesBefore: boolean;
+    continuesAfter: boolean;
+}
+interface DaySpanLayout {
+    placed: PlacedDaySpan[];
+    /** Ids that got no lane, in input order. */
+    hidden: string[];
+    /** The first day a hidden span covers, when there is one. */
+    firstHiddenDay?: string;
+}
+/**
+ * Places spans over one row of consecutive `days` (a week, or the single day of the Day
+ * view), in the order given, in at most `laneCap` lanes. Day membership is the end-exclusive
+ * zoned span. The time grid uses it for its top lane and its window strip.
+ */
+declare function layoutDaySpans(spans: readonly MonthSpanInput[], days: readonly string[], options: {
+    timeZone: string;
+    laneCap?: number;
+}): DaySpanLayout;
+/** A move the user asks for. The component never applies it: the consumer decides. */
+interface MoveProposal {
+    /** ISO 8601 instants of the proposed window. */
+    start: string;
+    end: string;
+    /** `'gap_forward'` when the wall-clock time asked for does not exist that day and moved past the gap. */
+    adjusted: 'gap_forward' | null;
+}
+/**
+ * The window `[start, end)` moved by `minutes` of real time and then by `days` calendar days.
+ * A day move keeps the wall-clock start and end (`addZonedDays`), whatever the length of the
+ * days in between. Compute it from the original window every time, so that a time falling in
+ * a clock-change gap moves forward once, never twice. When a clock change on the target day
+ * would put the wall-clock end at or before the start (a window that sits on the skipped or
+ * repeated hour), the end keeps the real length of the window instead.
+ */
+declare function proposeMove(span: {
+    start: string | number | Date;
+    end: string | number | Date;
+}, delta: {
+    days?: number;
+    minutes?: number;
+}, timeZone: string): MoveProposal;
 
-export { type LayoutMonthSpansOptions, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, type PlacedMonthSpan, itemDaySpan, layoutMonthSpans, schedulingGridDays };
+export { type DaySpanLayout, type LayoutMonthSpansOptions, type MonthSpanGroup, type MonthSpanInput, type MonthSpanLayout, type MoveProposal, type PlacedDaySpan, type PlacedMonthSpan, TOP_LANE_CROSS_MIDNIGHT_MINUTES, type TimeGridDayLayout, type TimeGridEntryInput, type TimeGridPart, type TimeGridSegment, itemDaySpan, layoutDaySpans, layoutMonthSpans, layoutTimeGridDay, placesInTopLane, proposeMove, schedulingGridDays };

package/dist/scheduling-calendar-model.js

@@ -1,4 +1,4 @@
-import { addCalendarDays, buildMonthGrid, packLanes, startOfMonth, zonedDateKey, zonedDaySpan } from "./calendar-model.js";
+import { addCalendarDays, addZonedDays, buildMonthGrid, packLanes, startOfMonth, zonedDateKey, zonedDayBounds, zonedDaySpan } from "./calendar-model.js";
 const DEFAULT_LANE_CAP = 2;
 function itemDaySpan(start, end, timeZone) {
   const from = new Date(start);
@@ -75,8 +75,102 @@ function layoutMonthSpans(spans, days, options) {
   }
   return { placed, hiddenByRow, firstHiddenDayByRow };
 }
+const MINUTE_MS = 6e4;
+const HOUR_MS = 36e5;
+const instantMs = (value) => new Date(value).getTime();
+const TOP_LANE_CROSS_MIDNIGHT_MINUTES = 360;
+function placesInTopLane(entry, timeZone, options = {}) {
+  if (entry.allDay) return true;
+  const start = instantMs(entry.start);
+  const end = instantMs(entry.end);
+  if (!(end > start)) return false;
+  if (end > addZonedDays(new Date(start), 1, timeZone).instant.getTime()) return true;
+  const firstMidnight = zonedDayBounds(zonedDateKey(new Date(start), timeZone), timeZone).end.getTime();
+  return end > firstMidnight + (options.crossMidnightMinutes ?? TOP_LANE_CROSS_MIDNIGHT_MINUTES) * MINUTE_MS;
+}
+function layoutTimeGridDay(entries, date, timeZone, options = {}) {
+  const bounds = zonedDayBounds(date, timeZone);
+  const dayStart = bounds.start.getTime();
+  const dayEnd = bounds.end.getTime();
+  const parts = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const start = instantMs(entry.start);
+    const end = Math.max(instantMs(entry.end), start);
+    const touches = end > start ? start < dayEnd && end > dayStart : start >= dayStart && start < dayEnd;
+    if (!touches || placesInTopLane(entry, timeZone, options)) continue;
+    parts.set(entry.id, {
+      start: Math.max(start, dayStart),
+      end: Math.min(end, dayEnd),
+      part: start < dayStart ? "continuation" : end > dayEnd ? "start" : "whole"
+    });
+  }
+  const packed = packLanes([...parts].map(([id, part]) => ({ id, start: part.start, end: part.end })), options.maxLanes ?? Infinity);
+  const segments = [];
+  const hidden = [];
+  for (const cluster of packed.clusters) {
+    for (const id of cluster.ids) {
+      const part = parts.get(id);
+      const lane = packed.lanes[id].lane;
+      if (lane === null) {
+        hidden.push(id);
+        continue;
+      }
+      segments.push({
+        id,
+        part: part.part,
+        start: part.start,
+        end: part.end,
+        offsetHours: (part.start - dayStart) / HOUR_MS,
+        lengthHours: (part.end - part.start) / HOUR_MS,
+        lane,
+        laneCount: Math.max(cluster.laneCount, 1)
+      });
+    }
+  }
+  return { date, dayStart, dayHours: (dayEnd - dayStart) / HOUR_MS, segments, hidden };
+}
+function layoutDaySpans(spans, days, options) {
+  if (days.length === 0) throw new RangeError("layoutDaySpans: days is empty");
+  const rowStart = days[0];
+  const rowEnd = addCalendarDays(days[days.length - 1], 1);
+  const seen = /* @__PURE__ */ new Set();
+  const inRow = spans.filter((span) => seen.has(span.id) ? false : (seen.add(span.id), true)).map((span) => ({ id: span.id, days: itemDaySpan(span.start, instantMs(span.end) < instantMs(span.start) ? span.start : span.end, options.timeZone) })).filter((span) => span.days.start < rowEnd && span.days.end > rowStart).map((span) => {
+    const from = span.days.start > rowStart ? span.days.start : rowStart;
+    const to = span.days.end < rowEnd ? span.days.end : rowEnd;
+    return { span, from, startCol: days.indexOf(from), endCol: days.indexOf(addCalendarDays(to, -1)) };
+  });
+  const packed = packLanes(inRow.map(({ span, startCol, endCol }) => ({ id: span.id, start: startCol, end: endCol + 1 })), options.laneCap ?? Infinity, { order: "given" });
+  const layout = { placed: [], hidden: [] };
+  for (const { span, from, startCol, endCol } of inRow) {
+    const lane = packed.lanes[span.id].lane;
+    if (lane === null) {
+      layout.hidden.push(span.id);
+      if (layout.firstHiddenDay === void 0 || from < layout.firstHiddenDay) layout.firstHiddenDay = from;
+      continue;
+    }
+    layout.placed.push({ id: span.id, lane, startCol, endCol, continuesBefore: span.days.start < rowStart, continuesAfter: span.days.end > rowEnd });
+  }
+  return layout;
+}
+function proposeMove(span, delta, timeZone) {
+  const shift = (delta.minutes ?? 0) * MINUTE_MS;
+  const start = new Date(instantMs(span.start) + shift);
+  const end = new Date(instantMs(span.end) + shift);
+  if (!delta.days) return { start: start.toISOString(), end: end.toISOString(), adjusted: null };
+  const movedStart = addZonedDays(start, delta.days, timeZone);
+  const movedEnd = addZonedDays(end, delta.days, timeZone);
+  const length = end.getTime() - start.getTime();
+  const collapsed = length > 0 && movedEnd.instant.getTime() <= movedStart.instant.getTime();
+  const proposedEnd = collapsed ? new Date(movedStart.instant.getTime() + length) : movedEnd.instant;
+  return { start: movedStart.instant.toISOString(), end: proposedEnd.toISOString(), adjusted: movedStart.adjusted ?? movedEnd.adjusted };
+}
 export {
+  TOP_LANE_CROSS_MIDNIGHT_MINUTES,
   itemDaySpan,
+  layoutDaySpans,
   layoutMonthSpans,
+  layoutTimeGridDay,
+  placesInTopLane,
+  proposeMove,
   schedulingGridDays
 };

package/package.json

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