@tensor_1/react 2.17.0 → 2.19.0

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import * as react from 'react';
 import { RefObject, ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, AriaAttributes, HTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, AnchorHTMLAttributes, DetailsHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes } from 'react';
+import { P as Placement } from './overlay-position-CEGSz6Z2.cjs';
+export { A as Align, a as PositionOptions, b as PositionResult, R as Rect, S as Side, c as Size, d as computePosition } from './overlay-position-CEGSz6Z2.cjs';
 
 declare function cx(...args: (string | false | null | undefined | 0)[]): string;
 
@@ -169,64 +171,6 @@ interface UseVirtualRowsResult<T> {
  */
 declare function useVirtualRows<T>(rows: readonly T[], { rowHeight, overscan, threshold }: UseVirtualRowsOptions): UseVirtualRowsResult<T>;
 
-/**
- * uix overlay positioning — framework-agnostic, dependency-free anchored placement.
- *
- * Pure geometry (no DOM): given the anchor's rect, the floating element's size, and
- * the viewport, compute where to put the floating element with two behaviours:
- *   • flip  — if the preferred side doesn't fit, use the opposite side (or whichever
- *             side has more room);
- *   • shift — slide along the cross axis so the element stays within the viewport.
- *
- * The React hook (useAnchoredPosition) and the vanilla styleguide both feed this
- * getBoundingClientRect() values, so anchored overlays land in the same place in every
- * browser — instead of relying on CSS anchor() positioning, which is Chromium-only and
- * silently detaches the overlay from its trigger everywhere else (UIX-FIX-02).
- *
- * Everything here is deterministic and unit-tested (see overlay-position.test.mjs).
- */
-type Side = 'top' | 'bottom' | 'left' | 'right';
-type Align = 'start' | 'center' | 'end';
-type Placement = Side | `${Side}-${Align}`;
-/** A viewport-space rectangle, as returned by getBoundingClientRect(). */
-interface Rect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-interface Size {
-    width: number;
-    height: number;
-}
-interface PositionOptions {
-    /** Preferred placement. Default `'bottom-start'`; a bare side (e.g. `'top'`) centers on the cross axis. */
-    placement?: Placement;
-    /** Gap between the anchor and the floating element, in px. Default 6. */
-    offset?: number;
-    /** Minimum gap kept from each viewport edge when shifting, in px. Default 8. */
-    padding?: number;
-    /** Flip to the opposite side when the preferred one doesn't fit. Default true. */
-    flip?: boolean;
-    /** Slide along the cross axis to stay on-screen. Default true. */
-    shift?: boolean;
-}
-interface PositionResult {
-    /** Viewport-space left, for `position: fixed`. */
-    x: number;
-    /** Viewport-space top, for `position: fixed`. */
-    y: number;
-    /** The placement actually used (after any flip). */
-    placement: Placement;
-    side: Side;
-    align: Align;
-}
-/**
- * Compute the floating element's viewport-space position anchored to `anchor`.
- * Coordinates are for `position: fixed` (same space as getBoundingClientRect).
- */
-declare function computePosition(anchor: Rect, floating: Size, viewport: Size, options?: PositionOptions): PositionResult;
-
 interface UseAnchoredPositionOptions {
     /** Reposition while true, and (re)attach scroll/resize listeners. */
     open: boolean;
@@ -612,14 +556,21 @@ interface TabPanelProps extends HTMLAttributes<HTMLDivElement> {
     /** The owning `<Tab>`'s value — the panel renders only while that tab is selected. */
     value: string;
     children?: ReactNode;
+    /**
+     * Keep the panel mounted while another tab is selected, `hidden` instead of removed.
+     * Opt in when leaving the tab would throw away work or a fetch the user already paid
+     * for — a loaded list, a half-filled form, a scroll position. Off by default: the
+     * panel's subtree then costs nothing until it is first shown.
+     */
+    keepMounted?: boolean;
 }
 /**
  * The tabpanel paired with a `<Tab>` by `value` (UIX-A11Y-2): labelled by its tab,
  * `tabIndex 0` so Tab from the tablist lands in the content, rendered only while
- * selected. Place it as a direct child of `<Tabs>` — it is hoisted out of the tablist —
- * or anywhere the Tabs context reaches.
+ * selected — or kept `hidden` with `keepMounted`. Place it as a direct child of
+ * `<Tabs>` — it is hoisted out of the tablist — or anywhere the Tabs context reaches.
  */
-declare function TabPanel({ value, children, ...props }: TabPanelProps): react.JSX.Element | null;
+declare function TabPanel({ value, children, keepMounted, ...props }: TabPanelProps): react.JSX.Element | null;
 
 type ShellNav = 'full' | 'rail' | 'hidden';
 interface AppShellProps extends HTMLAttributes<HTMLDivElement> {
@@ -1100,9 +1051,53 @@ interface CommentProps extends HTMLAttributes<HTMLDivElement> {
     author?: ReactNode;
     meta?: ReactNode;
     children?: ReactNode;
+    /**
+     * `person` (default) is someone's message. `system` is an event the product recorded —
+     * a status change, an assignment — drawn as chrome rather than as a speech bubble, and
+     * bylined with `systemLabel` instead of a person's name.
+     */
+    variant?: 'person' | 'system';
+    /** Byline for `variant="system"` when no `author` is given. Default "System". */
+    systemLabel?: string;
+    /** The message this one answers, quoted above the body. Text or a link to it. */
+    replyTo?: ReactNode;
+    /** Label on the quote. Default "In reply to". */
+    replyToLabel?: string;
+}
+/**
+ * A single comment over `.uix-comment` (avatar column + body). `variant="system"` marks
+ * product events apart from people; `replyTo` quotes the answered message. Mentions
+ * inside the body use the `.uix-mention` token.
+ */
+declare function Comment({ avatar, author, meta, children, className, variant, systemLabel, replyTo, replyToLabel, ...props }: CommentProps): react.JSX.Element;
+
+type SaveStatusState = 'idle' | 'saving' | 'saved' | 'failed';
+/** Every visible or announced string. Pass translations; English defaults fill the gaps. */
+interface SaveStatusLabels {
+    saving: string;
+    saved: string;
+    failed: string;
+    retry: string;
+}
+declare const DEFAULT_SAVE_STATUS_LABELS: SaveStatusLabels;
+interface SaveStatusProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Where the save is. `idle` shows nothing but keeps the live region in place. */
+    state: SaveStatusState;
+    labels?: Partial<SaveStatusLabels>;
+    /** Offered as a button only while `state` is `failed`. */
+    onRetry?: () => void;
 }
-/** A single comment over `.uix-comment` (avatar column + body). */
-declare function Comment({ avatar, author, meta, children, className, ...props }: CommentProps): react.JSX.Element;
+/**
+ * Inline save feedback over `.uix-save-status`: saving → saved → failed, with a retry.
+ * For autosave and inline edits, where a toast would be too loud and silence leaves the
+ * user guessing (LD-13).
+ *
+ * The status text sits in a polite live region that stays mounted in every state,
+ * including `idle`. A region inserted together with its text announces nothing, so
+ * rendering null while idle would silence the first "Saving…". The retry button sits
+ * outside the region so its label is not read out on every change.
+ */
+declare function SaveStatus({ state, labels, onRetry, className, ...props }: SaveStatusProps): react.JSX.Element;
 
 interface ComposerProps extends HTMLAttributes<HTMLDivElement> {
     children?: ReactNode;
@@ -1905,13 +1900,21 @@ interface RelationshipGraphNode {
     description?: string;
     x?: number;
     y?: number;
+    /** Layered layout: the node's column. Omitted → BFS distance from the root along source→target. */
+    depth?: number;
 }
+/** Where an edge's arrowhead sits: at the target (default), at the source, or nowhere. */
+type RelationshipGraphArrow = 'forward' | 'backward' | 'none';
 interface RelationshipGraphEdge {
     id: string;
     source: string;
     target: string;
     type?: string;
     label?: string;
+    /** Layered layout: arrowhead placement (default `forward`). */
+    arrow?: RelationshipGraphArrow;
+    /** Layered layout: always draw this edge's label, whatever the label policy. */
+    emphasis?: boolean;
 }
 interface PositionedRelationshipNode extends RelationshipGraphNode {
     x: number;
@@ -1927,11 +1930,157 @@ declare function boundRelationshipGraph(nodes: RelationshipGraphNode[], edges: R
 declare function relationshipNeighbors(nodeId: string, edges: RelationshipGraphEdge[]): string[];
 declare function layoutRelationshipGraph(nodes: RelationshipGraphNode[], edges: RelationshipGraphEdge[], rootId?: string): PositionedRelationshipNode[];
 declare function traverseRelationshipNode(nodes: RelationshipGraphNode[], currentId: string | undefined, direction: -1 | 1): string | undefined;
+type LayeredEdgeKind = 'forward' | 'lateral' | 'cycle';
+interface LayeredLayoutOptions {
+    rootId?: string;
+    /** Minimum sibling group size that collapses into a cluster. Default 6; 0 disables. */
+    clusterThreshold?: number;
+    expandedClusterIds?: ReadonlySet<string>;
+    density?: 'compact' | 'standard';
+}
+interface RelationshipGraphCluster {
+    id: string;
+    parentId: string;
+    depth: number;
+    type?: string;
+    edgeType?: string;
+    edgeLabel?: string;
+    members: RelationshipGraphNode[];
+}
+interface LayeredItem {
+    /** Node id, or cluster id for a collapsed cluster. */
+    id: string;
+    kind: 'node' | 'cluster';
+    node?: RelationshipGraphNode;
+    cluster?: RelationshipGraphCluster;
+    depth: number;
+    /** Position within its column (0-based, top to bottom). */
+    index: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Forward parents / children as item ids, in column order. */
+    parents: string[];
+    children: string[];
+    /** Set on the first member of an expanded cluster: the group its collapse control belongs to. */
+    expandedGroup?: RelationshipGraphCluster;
+    /** True when a lateral or cycle edge touches this node. */
+    inCycle: boolean;
+    /** Edges (any kind) touching this item. */
+    degree: number;
+}
+interface RoutedEdge {
+    id: string;
+    /** Item ids (a cluster id when the edge enters a collapsed cluster). */
+    source: string;
+    target: string;
+    kind: LayeredEdgeKind;
+    /** Original edge ids drawn by this path (several for a cluster). */
+    edgeIds: string[];
+    type?: string;
+    label?: string;
+    arrow: RelationshipGraphArrow;
+    emphasis: boolean;
+    path: string;
+    labelX: number;
+    labelY: number;
+    /** Arrowhead tip and the direction it points in (radians, 0 = pointing right). */
+    arrowX: number;
+    arrowY: number;
+    arrowAngle: number;
+    /** Label policy `auto` shows this label without interaction. */
+    autoLabel: boolean;
+    /** The label wrapped to fit the column gap (at most two lines). */
+    labelLines: string[];
+}
+interface LayeredColumn {
+    depth: number;
+    x: number;
+    /** Underlying nodes in the column, cluster members included. */
+    count: number;
+}
+interface LayeredLayout {
+    rootId: string | undefined;
+    items: LayeredItem[];
+    edges: RoutedEdge[];
+    clusters: RelationshipGraphCluster[];
+    columns: LayeredColumn[];
+    /** Node id → id of the item that currently draws it (itself, or its cluster). */
+    itemOf: Record<string, string>;
+    width: number;
+    height: number;
+    nodeWidth: number;
+    nodeHeight: number;
+    headerHeight: number;
+}
+/** Word-wrap a label into at most two lines that fit `width`; overlong words end in an ellipsis. */
+declare function wrapEdgeLabel(label: string, width: number): string[];
+interface LayeredEdgeClassification {
+    depthById: Map<string, number>;
+    kindById: Map<string, LayeredEdgeKind>;
+}
+/**
+ * Column (depth) for every node and a kind for every drawable edge.
+ * Supplied `node.depth` wins; otherwise BFS from the root along source→target.
+ * Nodes the BFS cannot reach go to a trailing column. Self-loops and edges with
+ * a missing endpoint get no kind and are not drawn.
+ */
+declare function classifyLayeredEdges(nodes: RelationshipGraphNode[], edges: RelationshipGraphEdge[], rootId?: string | undefined): LayeredEdgeClassification;
+declare function clusterIdFor(parentId: string, type: string | undefined, edgeType: string | undefined): string;
+/** Layered, clustered, crossing-reduced layout for `RelationshipGraph layout="layered"`. */
+declare function layoutLayeredGraph(nodes: RelationshipGraphNode[], edges: RelationshipGraphEdge[], options?: LayeredLayoutOptions): LayeredLayout;
+type LayeredNavigationKey = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End';
+/** Keyboard traversal over a layered layout: ←/→ along forward edges, ↑/↓ within a column. */
+declare function layeredNeighbor(layout: LayeredLayout, currentId: string | undefined, key: LayeredNavigationKey): string | undefined;
 
 interface RelationshipGraphLegendItem {
     id: string;
     label: string;
 }
+/** Every visible or announced string. Pass translations; English defaults fill the gaps. */
+interface RelationshipGraphLabels {
+    graph: string;
+    controls: string;
+    list: string;
+    listHeading: string;
+    legend: string;
+    panLeft: string;
+    panRight: string;
+    panUp: string;
+    panDown: string;
+    left: string;
+    right: string;
+    up: string;
+    down: string;
+    zoomIn: string;
+    zoomOut: string;
+    fit: string;
+    reset: string;
+    zoomLevel: (percent: number) => string;
+    bounded: (shown: number, omitted: number) => string;
+    graphSummary: (nodes: number, edges: number) => string;
+    relationship: string;
+    conflict: string;
+    connectedTo: (names: string) => string;
+    noConnections: string;
+    expandNeighbors: string;
+    openDetails: string;
+    /** Layered column header, e.g. "2 hops · 14". */
+    column: (depth: number, count: number) => string;
+    cluster: (count: number, type: string | undefined, edgeLabel: string | undefined) => string;
+    expandCluster: string;
+    collapseCluster: (count: number, type: string | undefined) => string;
+    cycle: string;
+    relationships: (count: number) => string;
+    roleDescription: string;
+    keyboardHint: string;
+    loading: string;
+    retry: string;
+    emptyTitle: string;
+    emptyHint: string;
+}
+declare const DEFAULT_RELATIONSHIP_GRAPH_LABELS: RelationshipGraphLabels;
 interface RelationshipGraphProps {
     nodes: RelationshipGraphNode[];
     edges: RelationshipGraphEdge[];
@@ -1939,6 +2088,7 @@ interface RelationshipGraphProps {
     onSelect?: (node: RelationshipGraphNode) => void;
     onExpandNeighbors?: (node: RelationshipGraphNode) => void;
     onOpenDetails?: (node: RelationshipGraphNode) => void;
+    /** Node budget. Default 40 (radial) or 400 (layered). */
     maxNodes?: number;
     density?: 'compact' | 'standard';
     highlightedNodeIds?: ReadonlySet<string>;
@@ -1950,9 +2100,39 @@ interface RelationshipGraphProps {
     error?: string;
     onRetry?: () => void;
     className?: string;
+    /** `radial` (default) rings around the selection; `layered` reads left to right by distance from `rootId`. */
+    layout?: 'radial' | 'layered';
+    /** Layered: the column-0 node (default: the first node). */
+    rootId?: string;
+    labels?: Partial<RelationshipGraphLabels>;
+    /** Layered: node body. Whatever it shows must also be in `nodeAriaLabel`. */
+    renderNode?: (node: RelationshipGraphNode, state: {
+        selected: boolean;
+        dimmed: boolean;
+    }) => ReactNode;
+    /** Layered: full accessible name for a node. */
+    nodeAriaLabel?: (node: RelationshipGraphNode) => string;
+    /** Layered: cluster body. Whatever it shows must also be in the cluster's accessible name. */
+    renderCluster?: (cluster: RelationshipGraphCluster) => ReactNode;
+    /** Layered: minimum leaf-sibling group that collapses into a cluster. Default 6; 0 disables. */
+    clusterThreshold?: number;
+    /** Layered: controlled set of expanded cluster ids. */
+    expandedClusterIds?: ReadonlySet<string>;
+    onToggleCluster?: (clusterId: string, expanded: boolean) => void;
+    /** Layered: nodes drawn muted (state must also be stated in text by the consumer). */
+    dimmedNodeIds?: ReadonlySet<string>;
+    /** Layered: when edge labels show. `auto` = emphasised edges, small fan-outs, and edges of the active node. */
+    edgeLabels?: 'auto' | 'always' | 'never';
+    /** Render the built-in equivalent list. Set false ONLY when an equivalent list is rendered in the same region. */
+    showList?: boolean;
+    /** Layered: CSS length for the viewport height. */
+    height?: string;
+    /** Layered: controlled roving focus. */
+    focusId?: string;
+    onFocusChange?: (id: string) => void;
 }
 /** Bounded, deterministic SVG relationship view with an equivalent accessible list. */
-declare function RelationshipGraph({ nodes, edges, selectedId, onSelect, onExpandNeighbors, onOpenDetails, maxNodes, density, highlightedNodeIds, conflictedNodeIds, highlightedEdgeIds, conflictedEdgeIds, legend, loading, error, onRetry, className, }: RelationshipGraphProps): react.JSX.Element;
+declare function RelationshipGraph(props: RelationshipGraphProps): react.JSX.Element;
 
 interface MatchReviewField {
     id: string;
@@ -2137,4 +2317,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, type Align, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CalendarDay, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, 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, DateRangePicker, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, 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, ForbiddenState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, Input, InputGroup, type InputGroupProps, type InputProps, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Label, type LabelProps, 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 MatchReviewProps, 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 PaginationProps, Peek, type PeekProps, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, type Placement, Popover, type PopoverProps, type PositionOptions, type PositionResult, type PositionedRelationshipNode, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, type Rect, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphEdge, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderProps, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleValidationIssue, type RuleValueEditorProps, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingEntryState, type SchedulingOverlayKind, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectProps, type ShellNav, type Side, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, type Size, 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, SubNavItem, type SubNavItemProps, Switch, type SwitchProps, 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 ToastProps, 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 UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, addCalendarDays, addCalendarMonths, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, clampMetricValue, clampWidth, computePosition, contrastRatio, cx, enumerateDateSpan, filterComboboxOptions, findRuleNodeDepth, flattenTree, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isRuleGroup, layoutRelationshipGraph, mapRuleGroup, matchFilter, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, parseDateValue, parseMetricValue, parseView, relationshipNeighbors, relativeTimeValue, removeRuleNode, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, searchRows, selectAllState, selectRangeDate, serializeView, shouldVirtualize, startOfMonth, stepMetricValue, summarizeDiff, summarizeRule, toDateKey, toggleId, togglePage, toggleSort, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useVirtualRows, validateRuleDefinition, virtualWindow, 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 BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CalendarDay, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, 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, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_SAVE_STATUS_LABELS, DateRangePicker, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, 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, ForbiddenState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, Input, InputGroup, type InputGroupProps, type InputProps, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, 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 MatchReviewProps, 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 PaginationProps, Peek, type PeekProps, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, Placement, 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 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, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingEntryState, type SchedulingOverlayKind, 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, SubNavItem, type SubNavItemProps, Switch, type SwitchProps, 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 ToastProps, 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 UseAnchoredPositionOptions, type UseTableOptions, type UseTableResult, type UseVirtualRowsOptions, type UseVirtualRowsResult, UserChip, type UserChipProps, ViewMenu, type ViewMenuColumn, type ViewMenuProps, type ViewState, type VirtualWindow, type ZonedDateSpan, addCalendarDays, addCalendarMonths, appendRuleNode, applyBrandProfile, applyFilters, boundRelationshipGraph, buildMonthGrid, buildThreeWayDiff, clampMetricValue, clampWidth, classifyLayeredEdges, clusterIdFor, contrastRatio, cx, enumerateDateSpan, filterComboboxOptions, findRuleNodeDepth, flattenTree, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isRuleGroup, layeredNeighbor, layoutLayeredGraph, layoutRelationshipGraph, mapRuleGroup, matchFilter, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, parseDateValue, parseMetricValue, parseView, relationshipNeighbors, relativeTimeValue, removeRuleNode, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, searchRows, selectAllState, selectRangeDate, serializeView, shouldVirtualize, startOfMonth, stepMetricValue, summarizeDiff, summarizeRule, toDateKey, toggleId, togglePage, toggleSort, traverseRelationshipNode, treeNav, useAnchoredPosition, useDialog, useTable, useVirtualRows, validateRuleDefinition, virtualWindow, wrapEdgeLabel, zonedDateKey, zonedDateSpan };

package/dist/index.d.ts

@@ -51,6 +51,7 @@ export { AsyncOperationState, AsyncOperationStatus, AsyncOperationStatusProps }
 export { Label, LabelProps } from './components/Label.js';
 export { Avatar, AvatarGroup, AvatarGroupProps, AvatarProps, UserChip, UserChipProps } from './components/Avatar.js';
 export { Comment, CommentProps, Comments, CommentsProps } from './components/Comments.js';
+export { DEFAULT_SAVE_STATUS_LABELS, SaveStatus, SaveStatusLabels, SaveStatusProps, SaveStatusState } from './components/SaveStatus.js';
 export { Composer, ComposerBar, ComposerBarProps, ComposerProps } from './components/Composer.js';
 export { Segmented, SegmentedOption, SegmentedOptionProps, SegmentedProps } from './components/Segmented.js';
 export { FilterOption, FilterPopover, FilterPopoverProps, SavedViewItem, SavedViewMenu, SavedViewMenuProps, ViewMenu, ViewMenuColumn, ViewMenuProps } from './components/TableControls.js';
@@ -72,8 +73,8 @@ export { BuilderCanvas, BuilderCanvasItem, BuilderCanvasProps, BuilderPaletteIte
 export { SchedulingCalendar, SchedulingCalendarEntry, SchedulingCalendarOverlay, SchedulingCalendarProps, SchedulingCalendarView, SchedulingEntryState, SchedulingOverlayKind } from './components/SchedulingCalendar.js';
 export { DateRangePicker, DateRangePickerProps } from './components/DateRangePicker.js';
 export { CalendarDay, DateRangeValue, ZonedDateSpan, addCalendarDays, addCalendarMonths, buildMonthGrid, enumerateDateSpan, isDateInRange, isDateUnavailable, selectRangeDate, startOfMonth, toDateKey, zonedDateKey, zonedDateSpan } from './calendar-model.js';
-export { RelationshipGraph, RelationshipGraphLegendItem, RelationshipGraphProps } from './components/RelationshipGraph.js';
-export { BoundedRelationshipGraph, PositionedRelationshipNode, RelationshipGraphEdge, RelationshipGraphNode, boundRelationshipGraph, layoutRelationshipGraph, relationshipNeighbors, traverseRelationshipNode } from './relationship-graph-model.js';
+export { DEFAULT_RELATIONSHIP_GRAPH_LABELS, RelationshipGraph, RelationshipGraphLabels, RelationshipGraphLegendItem, RelationshipGraphProps } from './components/RelationshipGraph.js';
+export { BoundedRelationshipGraph, LayeredColumn, LayeredEdgeClassification, LayeredEdgeKind, LayeredItem, LayeredLayout, LayeredLayoutOptions, LayeredNavigationKey, PositionedRelationshipNode, RelationshipGraphArrow, RelationshipGraphCluster, RelationshipGraphEdge, RelationshipGraphNode, RoutedEdge, boundRelationshipGraph, classifyLayeredEdges, clusterIdFor, layeredNeighbor, layoutLayeredGraph, layoutRelationshipGraph, relationshipNeighbors, traverseRelationshipNode, wrapEdgeLabel } from './relationship-graph-model.js';
 export { MatchBulkResult, MatchReview, MatchReviewAction, MatchReviewCandidate, MatchReviewField, MatchReviewProps } from './components/MatchReview.js';
 export { MetricInput, MetricInputProps } from './components/MetricInput.js';
 export { clampMetricValue, parseMetricValue, stepMetricValue } from './metric-model.js';

package/dist/index.js

@@ -65,6 +65,7 @@ import { AsyncOperationStatus } from "./components/AsyncOperationStatus.js";
 import { Label } from "./components/Label.js";
 import { Avatar, AvatarGroup, UserChip } from "./components/Avatar.js";
 import { Comments, Comment } from "./components/Comments.js";
+import { SaveStatus, DEFAULT_SAVE_STATUS_LABELS } from "./components/SaveStatus.js";
 import { Composer, ComposerBar } from "./components/Composer.js";
 import { Segmented, SegmentedOption } from "./components/Segmented.js";
 import { ViewMenu, FilterPopover, SavedViewMenu } from "./components/TableControls.js";
@@ -121,8 +122,8 @@ import {
   zonedDateKey,
   zonedDateSpan
 } from "./calendar-model.js";
-import { RelationshipGraph } from "./components/RelationshipGraph.js";
-import { boundRelationshipGraph, layoutRelationshipGraph, relationshipNeighbors, traverseRelationshipNode } from "./relationship-graph-model.js";
+import { RelationshipGraph, DEFAULT_RELATIONSHIP_GRAPH_LABELS } from "./components/RelationshipGraph.js";
+import { boundRelationshipGraph, layoutRelationshipGraph, relationshipNeighbors, traverseRelationshipNode, classifyLayeredEdges, clusterIdFor, layeredNeighbor, layoutLayeredGraph, wrapEdgeLabel } from "./relationship-graph-model.js";
 import { MatchReview } from "./components/MatchReview.js";
 import { MetricInput } from "./components/MetricInput.js";
 import { clampMetricValue, parseMetricValue, stepMetricValue } from "./metric-model.js";
@@ -163,6 +164,8 @@ export {
   ConfirmDialog,
   ContentList,
   ContentListItem,
+  DEFAULT_RELATIONSHIP_GRAPH_LABELS,
+  DEFAULT_SAVE_STATUS_LABELS,
   DateRangePicker,
   DescriptionItem,
   DescriptionList,
@@ -229,6 +232,7 @@ export {
   RowAction,
   RowActions,
   RuleBuilder,
+  SaveStatus,
   SavedViewMenu,
   SchedulingCalendar,
   SectionHead,
@@ -272,6 +276,8 @@ export {
   buildMonthGrid,
   buildThreeWayDiff,
   clampMetricValue,
+  classifyLayeredEdges,
+  clusterIdFor,
   computePosition,
   contrastRatio,
   cx,
@@ -285,6 +291,8 @@ export {
   isDateInRange,
   isDateUnavailable,
   isRuleGroup,
+  layeredNeighbor,
+  layoutLayeredGraph,
   layoutRelationshipGraph,
   mapRuleGroup,
   meetsContrast,
@@ -312,6 +320,7 @@ export {
   useTable,
   useVirtualRows,
   validateRuleDefinition,
+  wrapEdgeLabel,
   zonedDateKey,
   zonedDateSpan
 };

package/dist/markdown-model.d.ts

@@ -0,0 +1,75 @@
+type MarkdownInline = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'code';
+    value: string;
+} | {
+    type: 'strong';
+    children: MarkdownInline[];
+} | {
+    type: 'em';
+    children: MarkdownInline[];
+} | {
+    type: 'del';
+    children: MarkdownInline[];
+} | {
+    type: 'link';
+    href: string;
+    title?: string;
+    children: MarkdownInline[];
+    bare?: boolean;
+} | {
+    type: 'image';
+    src: string;
+    alt: string;
+    title?: string;
+} | {
+    type: 'br';
+};
+type TableAlign = 'left' | 'center' | 'right' | null;
+interface MarkdownListItem {
+    /** `null` for a plain item, otherwise the task state. */
+    checked: boolean | null;
+    children: MarkdownInline[];
+    /** Nested lists. */
+    lists: MarkdownList[];
+}
+interface MarkdownList {
+    type: 'list';
+    ordered: boolean;
+    start: number;
+    items: MarkdownListItem[];
+}
+type MarkdownBlock = {
+    type: 'paragraph';
+    children: MarkdownInline[];
+} | {
+    type: 'heading';
+    level: number;
+    children: MarkdownInline[];
+} | {
+    type: 'code';
+    lang: string;
+    value: string;
+} | {
+    type: 'quote';
+    children: MarkdownInline[];
+} | {
+    type: 'rule';
+} | MarkdownList | {
+    type: 'table';
+    align: TableAlign[];
+    head: MarkdownInline[][];
+    rows: MarkdownInline[][][];
+};
+/** Inline markdown to nodes. Newlines become line breaks. */
+declare function parseInline(text: string, depth?: number): MarkdownInline[];
+/** The text a reader sees, for accessible names and image alt text. */
+declare function plainText(nodes: ReadonlyArray<MarkdownInline>): string;
+/** Split a table row on unescaped pipes outside code spans. */
+declare function splitTableRow(line: string): string[];
+/** Markdown source to blocks. Empty or whitespace-only input yields no blocks. */
+declare function parseMarkdown(source: string): MarkdownBlock[];
+
+export { type MarkdownBlock, type MarkdownInline, type MarkdownList, type MarkdownListItem, type TableAlign, parseInline, parseMarkdown, plainText, splitTableRow };