@tensor_1/react 2.38.0 → 2.40.0

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import * as react from 'react';
 import { RefObject, AnchorHTMLAttributes, ReactNode, ButtonHTMLAttributes, HTMLAttributes, AriaAttributes, CSSProperties, SelectHTMLAttributes, Ref, InputHTMLAttributes, TextareaHTMLAttributes, MouseEvent, DetailsHTMLAttributes, LiHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes, ReactElement } from 'react';
 import { P as Placement } from './overlay-position-2Afke51l.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-2Afke51l.cjs';
+export { C as ChartStatPoint, L as LinearFit, P as PredictionBandPoint, l as linearFit, n as normalQuantile, p as predictionBand, q as quantiles, s as studentTQuantile } from './chart-stats-o4zDhpVm.cjs';
 
 declare function cx(...args: (string | false | null | undefined | 0)[]): string;
 
@@ -3219,12 +3220,19 @@ interface RelatedLinksProps extends Omit<HTMLAttributes<HTMLElement>, 'title' |
 declare function RelatedLinks({ title, items, className, ...props }: RelatedLinksProps): react.JSX.Element;
 
 interface ToggleRowProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** The row's visible label. It is the switch's `<label>`: clicking it flips the switch, and it names the switch. */
     label: ReactNode;
+    /** Shown under the label and announced as the switch's description (`aria-describedby`). */
     description?: ReactNode;
     checked: boolean;
     onCheckedChange: (checked: boolean) => void;
     disabled?: boolean;
-    accessibleLabel: string;
+    /**
+     * The switch's name when the visible label is not text (an icon, an image).
+     * Leave it out for a text label: the label already names the switch, and a
+     * repeated `aria-label` would replace it.
+     */
+    accessibleLabel?: string;
 }
 declare function ToggleRow({ label, description, checked, onCheckedChange, disabled, accessibleLabel, className, ...props }: ToggleRowProps): react.JSX.Element;
 
@@ -4019,6 +4027,88 @@ interface StatProps extends HTMLAttributes<HTMLElement> {
  */
 declare const Stat: react.ForwardRefExoticComponent<StatProps & react.RefAttributes<HTMLElement>>;
 
+type InsightStatusTone = 'ok' | 'warning' | 'critical' | 'unknown';
+interface InsightStatus {
+    tone: InsightStatusTone;
+    /** The words: the status is always readable without its colour or icon. */
+    label: string;
+}
+interface InsightComparison {
+    text: ReactNode;
+    /** Direction × whether that direction is good; `neutral` when it is neither. */
+    tone?: 'neutral' | 'positive' | 'negative' | 'warning';
+}
+interface InsightTarget {
+    actual: number;
+    target: number;
+    /** Qualitative bands from the start of the scale, e.g. [[0, 10], [10, 15], [15, 24]]. */
+    ranges?: [number, number][];
+    /** The scale's end. Default: the larger of the last range, the actual and the target, plus 10 %. */
+    max?: number;
+}
+interface InsightKpi {
+    value: ReactNode;
+    label: ReactNode;
+    comparison?: InsightComparison;
+    target?: InsightTarget;
+}
+interface InsightCoverage {
+    covered: number;
+    total: number;
+    /** What was counted, e.g. "changes classified". */
+    note: ReactNode;
+    /** Shown when the last period is still filling up. */
+    partialPeriod?: ReactNode;
+}
+/** Every word the card writes itself. English defaults in {@link DEFAULT_INSIGHT_CARD_LABELS}. */
+interface InsightCardLabels {
+    /** "412 of 431 changes classified (96%)". */
+    coverage: (covered: number, total: number, percent: number, note: ReactNode) => ReactNode;
+    /** The bullet's accessible description. */
+    bullet: (actual: string, target: string) => string;
+    source: string;
+    updated: string;
+    kpis: string;
+    formatNumber: (value: number) => string;
+}
+declare const DEFAULT_INSIGHT_CARD_LABELS: InsightCardLabels;
+interface InsightCardProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    eyebrow?: ReactNode;
+    /** The answer, as a sentence (≤ 10 words reads best). */
+    headline: ReactNode;
+    /** The implication and the suggested decision. */
+    sowhat?: ReactNode;
+    status?: InsightStatus;
+    kpis?: InsightKpi[];
+    coverage?: InsightCoverage;
+    /** One drill-down action (a link or button). */
+    actions?: ReactNode;
+    source?: ReactNode;
+    updated?: ReactNode;
+    /** `split` puts the aside on the right when the card is ≥ 60rem (960 px) wide; below, it stacks. */
+    layout?: 'stack' | 'split';
+    /**
+     * `card` (default) draws its own border and surface. `plain` draws none, for a card that sits
+     * inside another frame (a dashboard widget), so there is no card inside a card.
+     */
+    variant?: 'card' | 'plain';
+    aside?: ReactNode;
+    /** The headline's heading level. Default 3. */
+    headingLevel?: 2 | 3 | 4;
+    labels?: Partial<InsightCardLabels>;
+    children?: ReactNode;
+}
+declare function InsightCard({ eyebrow, headline, sowhat, status, kpis, coverage, actions, source, updated, layout, variant, aside, headingLevel, labels: labelOverrides, className, children, ...props }: InsightCardProps): react.JSX.Element;
+interface BulletProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'>, InsightTarget {
+    /** The accessible description, e.g. "18.7 h against a target of 15 h". */
+    label: string;
+}
+/**
+ * A bullet graph (Few): grey qualitative bands, a dark bar for the actual, a tick for the target.
+ * It replaces a gauge: the comparison is a length on one scale, not an angle.
+ */
+declare function Bullet({ actual, target, ranges, max, label, className, style, ...props }: BulletProps): react.JSX.Element;
+
 interface ChipProps extends Omit<HTMLAttributes<HTMLElement>, 'onClick'> {
     /** The chip's text. */
     children?: ReactNode;
@@ -4371,7 +4461,10 @@ interface CommentsProps extends HTMLAttributes<HTMLDivElement> {
  */
 declare function Comments({ children, className, ...props }: CommentsProps): react.JSX.Element;
 interface CommentProps extends HTMLAttributes<HTMLDivElement> {
-    /** Usually an `<Avatar />` (the grid reserves the leading column). */
+    /**
+     * Usually an `<Avatar />` (the grid reserves the leading column). `false` drops the
+     * column, for a comment that sits on a rail which already marks each row (a timeline).
+     */
     avatar?: ReactNode;
     author?: ReactNode;
     meta?: ReactNode;
@@ -5865,4 +5958,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 AvatarPresence, 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_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DATE_TIME_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_INLINE_EDIT_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_PRESENCE_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, DEFAULT_TREE_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, type DateInputProblem, type DatePart, DatePicker, type DatePickerLabels, type DatePickerProps, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DateTimePicker, type DateTimePickerLabels, type DateTimePickerProps, 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, type EntityPickerSearchResult, 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, InlineEdit, type InlineEditEditorProps, type InlineEditLabels, type InlineEditProps, 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 LayoutLaneOptions, 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, PresenceDot, type PresenceDotProps, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioCard, type RadioCardProps, 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 SchedulingAgendaGroup, 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 SchedulingTimelineGroup, 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 TimelineSubTick, 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 TreeLabels, 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, dateOrder, datePattern, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatDateKey, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, isValidDateKey, itemDaySpan, joinDateTime, layeredNeighbor, layoutDaySpans, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, layoutTimeGridDay, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateInput, 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, splitDateTime, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timeZoneName, timelineRepeatedHourOffset, timelineStepDelta, timelineSubTicks, 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 AvatarPresence, 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, Bullet, type BulletProps, 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_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DATE_TIME_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_ENTITY_PICKER_LABELS, DEFAULT_FILE_UPLOAD_LABELS, DEFAULT_FILTER_EDITOR_LABELS, DEFAULT_FILTER_SUMMARY_LABELS, DEFAULT_INLINE_EDIT_LABELS, DEFAULT_INSIGHT_CARD_LABELS, DEFAULT_LIGHTBOX_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_PRESENCE_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, DEFAULT_TREE_LABELS, DashboardGrid, type DashboardGridBreakpoint, type DashboardGridColumnCount, type DashboardGridColumns, type DashboardGridGap, DashboardGridItem, type DashboardGridItemProps, type DashboardGridProps, type DashboardGridSpan, type DateInputProblem, type DatePart, DatePicker, type DatePickerLabels, type DatePickerProps, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DateTimePicker, type DateTimePickerLabels, type DateTimePickerProps, 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, type EntityPickerSearchResult, 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, InlineEdit, type InlineEditEditorProps, type InlineEditLabels, type InlineEditProps, Input, InputGroup, type InputGroupProps, type InputProps, InsightCard, type InsightCardLabels, type InsightCardProps, type InsightComparison, type InsightCoverage, type InsightKpi, type InsightStatus, type InsightStatusTone, type InsightTarget, 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 LayoutLaneOptions, 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, PresenceDot, type PresenceDotProps, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioCard, type RadioCardProps, 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 SchedulingAgendaGroup, 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 SchedulingTimelineGroup, 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 TimelineSubTick, 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 TreeLabels, 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, dateOrder, datePattern, defaultTimelineStep, diffText, diffTokens, emptyFilterValue, enumerateDateKeys, enumerateDateSpan, fileKind, fileMatchesAccept, filterComboboxOptions, findRuleNodeDepth, flattenTree, foldForSearch, formatDateKey, formatFileSize, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isFilterEmpty, isRuleGroup, isValidDateKey, itemDaySpan, joinDateTime, layeredNeighbor, layoutDaySpans, layoutLane, layoutLayeredGraph, layoutMonthSpans, layoutRelationshipGraph, layoutTimeGridDay, mapRuleGroup, matchFilter, matchFilterPreset, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, packLanes, parseDateInput, 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, splitDateTime, startOfMonth, stepMetricValue, summarizeDiff, summarizeFilter, summarizeRule, textDiffRows, timeZoneName, timelineRepeatedHourOffset, timelineStepDelta, timelineSubTicks, 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

@@ -57,6 +57,8 @@ export { PillSize, PillTone, PillTreatment, StatusPill, StatusPillProps } from '
 export { Progress, ProgressProps } from './components/Progress.js';
 export { Meter, MeterProps, MeterTone } from './components/Meter.js';
 export { Stat, StatProps, StatTrend } from './components/Stat.js';
+export { Bullet, BulletProps, DEFAULT_INSIGHT_CARD_LABELS, InsightCard, InsightCardLabels, InsightCardProps, InsightComparison, InsightCoverage, InsightKpi, InsightStatus, InsightStatusTone, InsightTarget } from './components/InsightCard.js';
+export { ChartStatPoint, LinearFit, PredictionBandPoint, linearFit, normalQuantile, predictionBand, quantiles, studentTQuantile } from './chart-stats.js';
 export { Chip, ChipGroup, ChipGroupProps, ChipProps } from './components/Chip.js';
 export { Kbd, KbdCombo, KbdComboProps, KbdPlatform, KbdProps } from './components/Kbd.js';
 export { DEFAULT_STEP_STATE_LABELS, Step, StepProps, StepState, StepStateLabels, Steps, StepsProps } from './components/Steps.js';

package/dist/index.js

@@ -71,6 +71,8 @@ import { StatusPill } from "./components/StatusPill.js";
 import { Progress } from "./components/Progress.js";
 import { Meter } from "./components/Meter.js";
 import { Stat } from "./components/Stat.js";
+import { Bullet, DEFAULT_INSIGHT_CARD_LABELS, InsightCard } from "./components/InsightCard.js";
+import { linearFit, normalQuantile, predictionBand, quantiles, studentTQuantile } from "./chart-stats.js";
 import { Chip, ChipGroup } from "./components/Chip.js";
 import { Kbd, KbdCombo } from "./components/Kbd.js";
 import { Steps, Step, DEFAULT_STEP_STATE_LABELS } from "./components/Steps.js";
@@ -225,6 +227,7 @@ export {
   Breadcrumbs,
   BuilderCanvas,
   BulkBar,
+  Bullet,
   Button,
   ButtonGroup,
   ButtonLink,
@@ -263,6 +266,7 @@ export {
   DEFAULT_FILTER_EDITOR_LABELS,
   DEFAULT_FILTER_SUMMARY_LABELS,
   DEFAULT_INLINE_EDIT_LABELS,
+  DEFAULT_INSIGHT_CARD_LABELS,
   DEFAULT_LIGHTBOX_LABELS,
   DEFAULT_MATCH_REVIEW_LABELS,
   DEFAULT_PAGINATION_LABELS,
@@ -315,6 +319,7 @@ export {
   InlineEdit,
   Input,
   InputGroup,
+  InsightCard,
   Kanban,
   KanbanCard,
   KanbanColumn,
@@ -466,10 +471,12 @@ export {
   layoutMonthSpans,
   layoutRelationshipGraph,
   layoutTimeGridDay,
+  linearFit,
   mapRuleGroup,
   matchFilterPreset,
   meetsContrast,
   moveRuleNode,
+  normalQuantile,
   normalizeHex,
   packLanes,
   parseDateInput,
@@ -479,7 +486,9 @@ export {
   pixelsToMs,
   placeSpan,
   placesInTopLane,
+  predictionBand,
   proposeMove,
+  quantiles,
   rankOverflow,
   relationshipNeighbors,
   relativeTimeValue,
@@ -498,6 +507,7 @@ export {
   splitDateTime,
   startOfMonth,
   stepMetricValue,
+  studentTQuantile,
   summarizeDiff,
   summarizeFilter,
   summarizeRule,

package/dist/markdown-model-Cuwi6pIk.d.cts

@@ -0,0 +1,110 @@
+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;
+}
+/** `@[Display name](mention:<id>)` — a person mentioned by id; `label` is the stored name. */
+ | {
+    type: 'mention';
+    id: string;
+    label: string;
+} | {
+    type: 'br';
+};
+/**
+ * The one stored form of a mention: `@[Display name](mention:<id>)`. The id is the
+ * product's (a user id); the name is what the author saw, kept so the text still reads
+ * without the product. `[`, `]` and `\` in the name are backslash-escaped. Ids are
+ * limited to letters, digits and `_ . -`, so a mention can never carry a URL.
+ */
+declare const MENTION_SCHEME = "mention:";
+/** True when `id` can be stored in a mention. */
+declare function isMentionId(id: string): boolean;
+/** The markdown for one mention, or `null` when the id cannot be stored or the name is empty. */
+declare function formatMention(mention: {
+    id: string;
+    label: string;
+}): string | null;
+/**
+ * The mention at the start of `text`, with the number of characters it spans, or `null`.
+ * Used by the viewer, the editor and products that read stored text on the server.
+ */
+declare function readMention(text: string): {
+    id: string;
+    label: string;
+    length: number;
+} | null;
+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;
+/**
+ * Every mention in a markdown text, in reading order (an id may repeat). Code spans and
+ * code blocks hold no mentions. For products that act on mentions when text is saved.
+ */
+declare function findMentions(markdown: string): Array<{
+    id: string;
+    label: string;
+}>;
+/** Markdown source to blocks. Empty or whitespace-only input yields no blocks. */
+declare function parseMarkdown(source: string): MarkdownBlock[];
+
+export { MENTION_SCHEME as M, type TableAlign as T, type MarkdownBlock as a, type MarkdownInline as b, type MarkdownList as c, type MarkdownListItem as d, formatMention as e, findMentions as f, parseMarkdown as g, plainText as h, isMentionId as i, parseInline as p, readMention as r };

package/dist/markdown-model.d.ts

@@ -24,9 +24,38 @@ type MarkdownInline = {
     src: string;
     alt: string;
     title?: string;
+}
+/** `@[Display name](mention:<id>)` — a person mentioned by id; `label` is the stored name. */
+ | {
+    type: 'mention';
+    id: string;
+    label: string;
 } | {
     type: 'br';
 };
+/**
+ * The one stored form of a mention: `@[Display name](mention:<id>)`. The id is the
+ * product's (a user id); the name is what the author saw, kept so the text still reads
+ * without the product. `[`, `]` and `\` in the name are backslash-escaped. Ids are
+ * limited to letters, digits and `_ . -`, so a mention can never carry a URL.
+ */
+declare const MENTION_SCHEME = "mention:";
+/** True when `id` can be stored in a mention. */
+declare function isMentionId(id: string): boolean;
+/** The markdown for one mention, or `null` when the id cannot be stored or the name is empty. */
+declare function formatMention(mention: {
+    id: string;
+    label: string;
+}): string | null;
+/**
+ * The mention at the start of `text`, with the number of characters it spans, or `null`.
+ * Used by the viewer, the editor and products that read stored text on the server.
+ */
+declare function readMention(text: string): {
+    id: string;
+    label: string;
+    length: number;
+} | null;
 type TableAlign = 'left' | 'center' | 'right' | null;
 interface MarkdownListItem {
     /** `null` for a plain item, otherwise the task state. */
@@ -67,9 +96,17 @@ type MarkdownBlock = {
 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;
+/**
+ * Every mention in a markdown text, in reading order (an id may repeat). Code spans and
+ * code blocks hold no mentions. For products that act on mentions when text is saved.
+ */
+declare function findMentions(markdown: string): Array<{
+    id: string;
+    label: 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 };
+export { MENTION_SCHEME, type MarkdownBlock, type MarkdownInline, type MarkdownList, type MarkdownListItem, type TableAlign, findMentions, formatMention, isMentionId, parseInline, parseMarkdown, plainText, readMention, splitTableRow };

package/dist/markdown-model.js

@@ -1,3 +1,21 @@
+const MENTION_SCHEME = "mention:";
+const MENTION_ID = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/;
+const MENTION_RE = /^@\[((?:\\[\\[\]]|[^\\[\]\n]){1,200})\]\(mention:([A-Za-z0-9][A-Za-z0-9_.-]{0,127})\)/;
+const cleanMentionLabel = (label) => label.replace(/\s+/gu, " ").trim().slice(0, 200);
+function isMentionId(id) {
+  return MENTION_ID.test(id);
+}
+function formatMention(mention) {
+  const label = cleanMentionLabel(mention.label);
+  if (!isMentionId(mention.id) || !label) return null;
+  return `@[${label.replace(/[\\[\]]/g, (ch) => `\\${ch}`)}](${MENTION_SCHEME}${mention.id})`;
+}
+function readMention(text) {
+  const match = MENTION_RE.exec(text);
+  if (!match) return null;
+  const label = cleanMentionLabel(match[1].replace(/\\([\\[\]])/g, "$1"));
+  return label ? { id: match[2], label, length: match[0].length } : null;
+}
 const ASCII_PUNCT = /[!-/:-@[-`{-~]/;
 const WORD = /[\p{L}\p{N}]/u;
 const NAMED_ENTITIES = {
@@ -152,6 +170,14 @@ function parseInline(text, depth = 0) {
       i += run.length;
       continue;
     }
+    if (ch === "@" && text[i + 1] === "[") {
+      const mention = readMention(rest);
+      if (mention) {
+        out.push({ type: "mention", id: mention.id, label: mention.label });
+        i += mention.length;
+        continue;
+      }
+    }
     if (ch === "!" && text[i + 1] === "[") {
       const end = findBracketEnd(text, i + 1);
       const dest = end > 0 ? readDestination(text, end + 1) : null;
@@ -246,11 +272,47 @@ function plainText(nodes) {
         return " ";
       case "image":
         return n.alt;
+      case "mention":
+        return `@${n.label}`;
       default:
         return plainText(n.children);
     }
   }).join("");
 }
+const collectMentions = (nodes, out) => {
+  for (const n of nodes) {
+    if (n.type === "mention") out.push({ id: n.id, label: n.label });
+    else if ("children" in n) collectMentions(n.children, out);
+  }
+};
+function findMentions(markdown) {
+  const out = [];
+  const walkList = (list) => {
+    for (const item of list.items) {
+      collectMentions(item.children, out);
+      item.lists.forEach(walkList);
+    }
+  };
+  for (const block of parseMarkdown(markdown)) {
+    switch (block.type) {
+      case "paragraph":
+      case "heading":
+      case "quote":
+        collectMentions(block.children, out);
+        break;
+      case "list":
+        walkList(block);
+        break;
+      case "table":
+        block.head.forEach((cell) => collectMentions(cell, out));
+        block.rows.forEach((row) => row.forEach((cell) => collectMentions(cell, out)));
+        break;
+      default:
+        break;
+    }
+  }
+  return out;
+}
 const FENCE_RE = /^(`{3,}|~{3,})\s*([^`\s]*)/;
 const HEADING_RE = /^(#{1,6})\s+(.*?)(?:\s+#+)?$/;
 const RULE_RE = /^(?:(?:\*\s*){3,}|(?:-\s*){3,}|(?:_\s*){3,})$/;
@@ -431,8 +493,13 @@ ${current.trim()}`;
   return blocks;
 }
 export {
+  MENTION_SCHEME,
+  findMentions,
+  formatMention,
+  isMentionId,
   parseInline,
   parseMarkdown,
   plainText,
+  readMention,
   splitTableRow
 };