@tensor_1/react 2.24.0 → 2.26.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { RefObject, ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, AriaAttributes, HTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes, AnchorHTMLAttributes, MouseEvent, DetailsHTMLAttributes, TdHTMLAttributes, TableHTMLAttributes, ThHTMLAttributes } from 'react';
+import { RefObject, ButtonHTMLAttributes, ReactNode, InputHTMLAttributes, AriaAttributes, HTMLAttributes, Ref, TextareaHTMLAttributes, SelectHTMLAttributes, AnchorHTMLAttributes, MouseEvent, 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';
 
@@ -250,6 +250,108 @@ interface ComboboxProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>
 /** Searchable single-select combobox with keyboard navigation and no framework dependencies. */
 declare function Combobox({ options, value, defaultValue, onValueChange, label, placeholder, emptyLabel, name, disabled, className, ...props }: ComboboxProps): react.JSX.Element;
 
+/** One result row. */
+interface SearchSuggestOption {
+    /** Stable id, returned by `onSelect`. */
+    id: string;
+    /** The result's name. Matched letters are emphasised. */
+    title: string;
+    /** Where the result lives, outermost first (a breadcrumb). Middle crumbs truncate first. */
+    meta?: readonly string[];
+    /** One or two lines of context, clamped at two lines. Matched letters are emphasised. */
+    description?: string;
+    /** Optional leading glyph (decorative). */
+    icon?: ReactNode;
+}
+/** A labelled action inside the list (the footer row, the heading action). */
+interface SearchSuggestAction {
+    /** Visible text of the action. */
+    label: string;
+    /** Runs when the action is chosen. */
+    onSelect: () => void;
+}
+/** Props of {@link SearchSuggest}. */
+interface SearchSuggestProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'onSelect' | 'title' | 'defaultValue'> {
+    /** The text in the field (controlled). */
+    value: string;
+    /** Called on every edit, and with an empty string when the field is cleared. */
+    onValueChange: (value: string) => void;
+    /** The suggestions to show, best first. The consumer filters; this component only renders. */
+    options: readonly SearchSuggestOption[];
+    /** Called when a row is chosen by click or Enter. The list closes afterwards. */
+    onSelect: (id: string, option: SearchSuggestOption) => void;
+    /** Accessible name of the field (there is no visible label; the placeholder is not a label). */
+    label: string;
+    placeholder?: string;
+    /** Text to emphasise in rows. Defaults to `value`. */
+    highlight?: string;
+    /** A title above the options, e.g. "Recently opened". */
+    heading?: string;
+    /** A small action next to the heading, e.g. "Clear". */
+    headingAction?: SearchSuggestAction;
+    /** A last row after the options, e.g. "Show all 23 results". Reachable by arrow keys. */
+    footer?: SearchSuggestAction;
+    /** The field is fetching suggestions: a spinner shows in the field and, with no options yet, in the list. */
+    loading?: boolean;
+    /** Announced while loading, and shown in the list when it has no rows yet. */
+    loadingLabel?: string;
+    /** Shown when the field has text, nothing is loading and there are no options. */
+    empty?: ReactNode;
+    /** Shown instead of the empty state when suggestions could not be loaded. */
+    error?: ReactNode;
+    /** A keyboard hint shown in the empty, unfocused field, e.g. "/". */
+    shortcutHint?: string;
+    /** Accessible name of the clear button (default "Clear search"). */
+    clearLabel?: string;
+    /** A polite announcement, e.g. "8 results". Rendered in a visually hidden live region. */
+    status?: string;
+    /** `lg` for a page-level search (hubs, start pages); `md` for a field in a toolbar or header. */
+    size?: 'md' | 'lg';
+    /** Controlled open state of the suggestion list (optional). */
+    open?: boolean;
+    /** Called when the list opens or closes. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * `absolute` (default) places the list under the field inside its own box. `fixed` floats it on
+     * the viewport, so a clipping ancestor (`overflow: hidden` toolbars and headers) cannot cut it off;
+     * it follows the field on scroll and resize and flips above it when there is no room below.
+     */
+    strategy?: 'absolute' | 'fixed';
+    /** Focus the field from outside (e.g. a "/" shortcut). */
+    inputRef?: Ref<HTMLInputElement | null>;
+    /** Focus the field on mount. */
+    autoFocus?: boolean;
+    /** Form field name of the input. */
+    name?: string;
+}
+/**
+ * A search field with a suggestion list underneath: the "search and jump" pattern of Windows
+ * Settings, Android Settings and most docs sites. Each row shows a name, where it lives and a line
+ * of context. ARIA combobox pattern: focus stays in the field, arrow keys move the active row
+ * (`aria-activedescendant`), Enter opens it (the first row when none is active), Escape closes the
+ * list and a second Escape clears the text.
+ */
+declare function SearchSuggest({ value, onValueChange, options, onSelect, label, placeholder, highlight, heading, headingAction, footer, loading, loadingLabel, empty, error, shortcutHint, clearLabel, status, size, open: openProp, strategy, onOpenChange, inputRef, autoFocus, name, className, onBlur, ...props }: SearchSuggestProps): react.JSX.Element;
+
+/** One run of a result's text, emphasised or not. */
+interface SearchSegment {
+    text: string;
+    match: boolean;
+}
+/** Text folded for matching, with a map back to the original characters. */
+interface FoldedText {
+    /** The folded text: lower case, diacritics stripped, ß → ss. */
+    text: string;
+    /** For each index of `text`, the start index of the original character it came from. */
+    source: number[];
+    /** For each index of `text`, the end index (exclusive) of that original character. */
+    sourceEnd: number[];
+}
+/** Fold `text` for matching and keep a map back to the original indices. */
+declare function foldForSearch(text: string): FoldedText;
+/** Split `text` into matched and unmatched segments for `query`. */
+declare function searchSegments(text: string, query: string): SearchSegment[];
+
 interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
     invalid?: boolean;
 }
@@ -289,11 +391,19 @@ interface FieldProps {
     error?: string;
     success?: string;
     required?: boolean;
+    /**
+     * Plain-text help behind a ? button after the label (before the required marker). Blank
+     * lines separate paragraphs; empty, whitespace-only or `null` renders no button. Needs `label`.
+     * Keep format or validation instructions in `hint`, where they stay visible.
+     */
+    help?: string | null;
+    /** Accessible name of the ? button. Default `"About: <label>"`; pass a localised one. */
+    helpLabel?: string;
     children: ReactNode;
     className?: string;
     htmlFor?: string;
 }
-declare function Field({ label, hint, error, success, required, children, className, htmlFor }: FieldProps): react.JSX.Element;
+declare function Field({ label, hint, error, success, required, help, helpLabel, children, className, htmlFor }: FieldProps): react.JSX.Element;
 
 interface ModalProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     open: boolean;
@@ -343,11 +453,17 @@ interface DrawerProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     closeLabel?: string;
     open: boolean;
     onClose?: () => void;
+    /**
+     * A click on the dimmed backdrop calls `onClose`, like Escape and the close button
+     * (TENSOR HAR-547). Pass `false` on a drawer that holds unsaved form input, so a stray click
+     * can't discard it; Escape and the close button still close. Default `true`.
+     */
+    dismissOnBackdrop?: boolean;
     title?: ReactNode;
     children?: ReactNode;
     footer?: ReactNode;
 }
-declare function Drawer({ open, onClose, title, children, footer, closeLabel, className, ...rest }: DrawerProps): react.JSX.Element;
+declare function Drawer({ open, onClose, dismissOnBackdrop, title, children, footer, closeLabel, className, onClick, ...rest }: DrawerProps): react.JSX.Element;
 
 interface PeekProps extends Omit<HTMLAttributes<HTMLDialogElement>, 'title'> {
     /** TENSOR RX-125 (UIX-04): translatable; English default. */
@@ -372,11 +488,18 @@ interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
     /** Element for the title — pick a real heading to slot the card into the page outline (UIX-A11Y-4). Default `div` keeps legacy rendering. */
     titleAs?: 'h2' | 'h3' | 'h4' | 'div';
     subtitle?: ReactNode;
+    /**
+     * Plain-text help behind a ? button after the title. Blank lines separate paragraphs;
+     * empty, whitespace-only or `null` renders no button.
+     */
+    help?: string | null;
+    /** Accessible name of the ? button. Default `"About: <title>"` when title is text; pass a localised one. */
+    helpLabel?: string;
     headerAction?: ReactNode;
     footer?: ReactNode;
     children?: ReactNode;
 }
-declare function Card({ title, titleAs: TitleTag, subtitle, headerAction, footer, children, className, ...props }: CardProps): react.JSX.Element;
+declare function Card({ title, titleAs: TitleTag, subtitle, help, helpLabel, headerAction, footer, children, className, ...props }: CardProps): react.JSX.Element;
 interface CardLinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'title'> {
     title?: ReactNode;
     subtitle?: ReactNode;
@@ -408,14 +531,21 @@ interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
     as?: 'h1' | 'h2';
     /** Supporting copy under the title. */
     subtitle?: ReactNode;
+    /**
+     * Plain-text help behind a ? button right after the title. Blank lines separate paragraphs;
+     * empty, whitespace-only or `null` renders no button.
+     */
+    help?: string | null;
+    /** Accessible name of the ? button. Default `"About: <title>"` when title is text; pass a localised one. */
+    helpLabel?: string;
     /** Right-aligned action area (buttons, menus). */
     actions?: ReactNode;
 }
 /**
- * Page header — eyebrow / title / subtitle + actions row, over `.uix-page-header`.
+ * Page header — eyebrow / title (+ optional `help` ?) / subtitle + actions row, over `.uix-page-header`.
  * The hairline + breathing room below come from the component CSS.
  */
-declare function PageHeader({ eyebrow, title, subtitle, actions, as: TitleTag, className, ...props }: PageHeaderProps): react.JSX.Element;
+declare function PageHeader({ eyebrow, title, subtitle, help, helpLabel, actions, as: TitleTag, className, ...props }: PageHeaderProps): react.JSX.Element;
 
 interface DetailLayoutProps extends HTMLAttributes<HTMLDivElement> {
     /** The narrow trailing column (record meta, side panels). */
@@ -1017,6 +1147,30 @@ interface TooltipProps extends HTMLAttributes<HTMLSpanElement> {
  */
 declare function Tooltip({ label, placement, className, children, ...props }: TooltipProps): react.JSX.Element;
 
+interface InfoTipProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'content' | 'children'> {
+    /**
+     * Help text, rendered as plain text (never HTML). A blank line starts a new paragraph.
+     * Empty or whitespace-only text renders nothing, so a missing help string needs no guard.
+     */
+    content: string;
+    /** Accessible name of the ? button, e.g. "About: Incidents". The consumer localises it. */
+    label: string;
+    /** Preferred panel placement. Default `'bottom-start'`. */
+    placement?: Placement;
+}
+/**
+ * A small ? that explains a page, section or field. It is a fixed 9 px glyph, superscript at
+ * the top right of the text it follows (25 px hit area). The panel opens on hover (after a short delay), on
+ * keyboard focus, and on click or tap; a click keeps it open until a second click, Esc or a
+ * click outside. Esc returns focus to the button. The panel is plain text in
+ * the top layer (kit `Popover`, `popover="manual"`, so opening it never closes another popover)
+ * and is the button's `aria-describedby`, so the text is announced on focus.
+ *
+ * Do not put it inside a `<label>`, a heading or a link: `Field`, `PageHeader`, `Card` and
+ * `SectionHead` place it beside those through their `help` prop.
+ */
+declare function InfoTip({ content, ...props }: InfoTipProps): react.JSX.Element | null;
+
 type StateVariant = 'section' | 'inline' | 'drawer' | 'page' | 'full-page';
 interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
     icon?: ReactNode;
@@ -1733,11 +1887,18 @@ interface SectionHeadProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'>
     title: ReactNode;
     /** id for the `<h2>`, for `aria-labelledby` wiring on the enclosing section. */
     titleId?: string;
+    /**
+     * Plain-text help behind a ? button after the title. Blank lines separate paragraphs;
+     * empty, whitespace-only or `null` renders no button.
+     */
+    help?: string | null;
+    /** Accessible name of the ? button. Default `"About: <title>"` when title is text; pass a localised one. */
+    helpLabel?: string;
     /** Right-aligned slot — a `.uix-section-link` anchor, a button, a pill. */
     action?: ReactNode;
 }
-/** Section head — title row with an optional trailing action (`.uix-section-head`). */
-declare function SectionHead({ title, titleId, action, className, ...props }: SectionHeadProps): react.JSX.Element;
+/** Section head — title row (+ optional `help` ?) with an optional trailing action (`.uix-section-head`). */
+declare function SectionHead({ title, titleId, help, helpLabel, action, className, ...props }: SectionHeadProps): react.JSX.Element;
 interface NoticeQueueProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
     /** Leading icon slot. */
     icon?: ReactNode;
@@ -2759,4 +2920,4 @@ declare function hsvToHex(value: HsvColor): string;
 declare function contrastRatio(background: string, foreground: string): number | undefined;
 declare function meetsContrast(background: string, foreground: string, minimum?: number): boolean;
 
-export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CalendarDay, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, 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 MatchReviewLabels, 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 PaginationLabels, 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 RuleBuilderLabels, type RuleBuilderProps, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleValidationIssue, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type 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 ViewMenuColumnLabels, 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 };
+export { type AccessStateProps, Alert, type AlertProps, type AlertTone, AppShell, type AppShellProps, type AppliedBrandProfileSnapshot, type AsyncOperationState, AsyncOperationStatus, type AsyncOperationStatusProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, type BoundedRelationshipGraph, type BrandProfile, BrandProfileEditor, type BrandProfileEditorLabels, type BrandProfileEditorProps, type BrandProfileLogo, type BrandProfileTypography, BrandProfiles, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BuilderCanvas, type BuilderCanvasItem, type BuilderCanvasLabels, type BuilderCanvasProps, type BuilderPaletteItem, BulkBar, type BulkBarProps, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type CalendarDay, Card, CardLink, type CardLinkProps, type CardProps, CellStrong, CellSub, Checkbox, type CheckboxProps, CollapsibleSection, type CollapsibleSectionProps, ColorPicker, type ColorPickerLabels, type ColorPickerProps, type ColumnFilter, Combobox, type ComboboxOption, type ComboboxProps, CommandGroup, type CommandGroupProps, CommandItem, type CommandItemProps, CommandPalette, type CommandPaletteProps, Comment, type CommentProps, Comments, type CommentsProps, Composer, ComposerBar, type ComposerBarProps, type ComposerProps, ConfirmDialog, type ConfirmDialogProps, ContentList, ContentListItem, type ContentListItemProps, type ContentListProps, CopyButton, type CopyButtonProps, DEFAULT_BRAND_PROFILE_EDITOR_LABELS, DEFAULT_BUILDER_CANVAS_LABELS, DEFAULT_COLOR_PICKER_LABELS, DEFAULT_DATE_RANGE_PICKER_LABELS, DEFAULT_DIFF_VIEWER_LABELS, DEFAULT_MATCH_REVIEW_LABELS, DEFAULT_PAGINATION_LABELS, DEFAULT_RELATIONSHIP_GRAPH_LABELS, DEFAULT_RULE_BUILDER_LABELS, DEFAULT_SAVE_STATUS_LABELS, DEFAULT_SCHEDULING_CALENDAR_LABELS, DateRangePicker, type DateRangePickerLabels, type DateRangePickerProps, type DateRangeValue, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListItem, type DescriptionListProps, DetailLayout, type DetailLayoutProps, DetailPage, type DetailPageLinkProps, type DetailPageMetric, type DetailPageProps, type DetailPageTab, type DiffEntry, type DiffKind, type DiffResolution, type DiffSummary, DiffViewer, type DiffViewerLabels, type DiffViewerProps, Drawer, type DrawerProps, EmptyState, type EmptyStateProps, ErrorState, type ErrorStateProps, EventRow, type EventRowProps, ExpandToggle, type ExpandToggleProps, FeaturedRundown, FeaturedRundownItem, type FeaturedRundownItemProps, type FeaturedRundownProps, FeaturedStage, type FeaturedStageProps, Field, type FieldProps, type FilterKind, type FilterOp, type FilterOption, FilterPopover, type FilterPopoverProps, FilteredEmptyState, type FlatNode, Flow, FlowNode, type FlowNodeProps, type FlowNodeState, type FlowProps, type FlowVariant, type FoldedText, ForbiddenState, Highlighted, type HighlightedProps, type HsvColor, Inbox, InboxDetail, type InboxDetailProps, InboxItem, type InboxItemProps, InboxList, type InboxListProps, type InboxProps, InfoTip, type InfoTipProps, Input, InputGroup, type InputGroupProps, type InputProps, type JsonPrimitive, type JsonValue, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanMoveDirection, type KanbanProps, Label, type LabelProps, type LayeredColumn, type LayeredEdgeClassification, type LayeredEdgeKind, type LayeredItem, type LayeredLayout, type LayeredLayoutOptions, type LayeredNavigationKey, LicensePositionBar, type LicensePositionBarProps, List, ListItem, type ListItemProps, type ListProps, LoadingState, type LoadingStateProps, Mark, type MarkProps, type MatchBulkResult, MatchReview, type MatchReviewAction, type MatchReviewCandidate, type MatchReviewField, type MatchReviewLabels, type MatchReviewProps, Meter, type MeterProps, type MeterTone, MetricInput, type MetricInputProps, Modal, type ModalProps, type NavFavouriteItem, NavFavourites, type NavFavouritesLabels, type NavFavouritesProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, NewsLead, type NewsLeadProps, NotFoundState, Note, type NoteProps, type NoteTone, NoticeQueue, type NoticeQueueProps, PageHeader, type PageHeaderProps, PageIntro, type PageIntroProps, Pagination, type PaginationLabels, type PaginationProps, Peek, type PeekProps, type PillTone, type PillTreatment, Pipeline, type PipelineProps, PipelineStage, type PipelineStageProps, type PipelineStageState, Placement, Popover, type PopoverProps, type PositionedRelationshipNode, type Primitive, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Prose, type ProseProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, type RelatedLinkItem, RelatedLinks, type RelatedLinksProps, RelationshipGraph, type RelationshipGraphArrow, type RelationshipGraphCluster, type RelationshipGraphEdge, type RelationshipGraphLabels, type RelationshipGraphLegendItem, type RelationshipGraphNode, type RelationshipGraphProps, RelativeTime, type RelativeTimeFormatContext, type RelativeTimeProps, type RelativeTimeUnit, type RelativeTimeValue, ResourceGrid, type ResourceGridProps, type RgbColor, type RoutedEdge, type Row, RowAction, type RowActionProps, RowActions, type RowActionsProps, type RuleAction, type RuleActionDefinition, RuleBuilder, type RuleBuilderLabels, type RuleBuilderProps, type RuleCondition, type RuleDefinition, type RuleFieldDefinition, type RuleGroup, type RuleOperatorDefinition, type RuleValidationIssue, type RuleValueEditorProps, SaveStatus, type SaveStatusLabels, type SaveStatusProps, type SaveStatusState, type SavedViewItem, SavedViewMenu, type SavedViewMenuProps, type SavedViewSection, SchedulingCalendar, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingEntryState, type SchedulingOverlayKind, type SearchSegment, SearchSuggest, type SearchSuggestAction, type SearchSuggestOption, type SearchSuggestProps, SectionHead, type SectionHeadProps, type Segment, Segmented, SegmentedOption, type SegmentedOptionProps, type SegmentedProps, Select, type SelectAllState, type SelectProps, type ShellNav, Sidebar, type SidebarProps, SidebarSection, type SidebarSectionProps, Skeleton, type SkeletonProps, type SortDir, type SortDirection, type SortKey, Spinner, type SpinnerProps, StarButton, type StarButtonProps, Stat, StatLine, type StatLineItem, type StatLineProps, type StatProps, type StatTrend, type StateVariant, StatusPill, type StatusPillProps, StatusRow, type StatusRowProps, 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 ViewMenuColumnLabels, 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, foldForSearch, hexToRgb, highlightSegments, hsvToHex, hsvToRgb, isDateInRange, isDateUnavailable, isRuleGroup, layeredNeighbor, layoutLayeredGraph, layoutRelationshipGraph, mapRuleGroup, matchFilter, meetsContrast, mergePinned, moveRuleNode, multiSort, nextSortDir, normalizeHex, parseDateValue, parseMetricValue, parseView, relationshipNeighbors, relativeTimeValue, removeRuleNode, reorder, restoreBrandProfile, rgbToHex, rgbToHsv, ruleDepth, searchRows, searchSegments, 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

@@ -8,6 +8,8 @@ export { Button, ButtonGroup, ButtonGroupProps, ButtonProps } from './components
 export { Input, InputGroup, InputGroupProps, InputProps } from './components/Input.js';
 export { Combobox, ComboboxProps } from './components/Combobox.js';
 export { ComboboxOption, filterComboboxOptions } from './combobox-model.js';
+export { SearchSuggest, SearchSuggestAction, SearchSuggestOption, SearchSuggestProps } from './components/SearchSuggest.js';
+export { FoldedText, SearchSegment, foldForSearch, searchSegments } from './search-suggest-model.js';
 export { Textarea, TextareaProps } from './components/Textarea.js';
 export { Select, SelectProps } from './components/Select.js';
 export { Checkbox, CheckboxProps } from './components/Checkbox.js';
@@ -45,6 +47,7 @@ export { Progress, ProgressProps } from './components/Progress.js';
 export { Meter, MeterProps, MeterTone } from './components/Meter.js';
 export { Stat, StatProps, StatTrend } from './components/Stat.js';
 export { Tooltip, TooltipProps } from './components/Tooltip.js';
+export { InfoTip, InfoTipProps } from './components/InfoTip.js';
 export { AccessStateProps, EmptyState, EmptyStateProps, ErrorState, ErrorStateProps, FilteredEmptyState, ForbiddenState, LoadingState, LoadingStateProps, NotFoundState, Skeleton, SkeletonProps, StateVariant } from './components/States.js';
 export { RelativeTime, RelativeTimeFormatContext, RelativeTimeProps } from './components/RelativeTime.js';
 export { RelativeTimeUnit, RelativeTimeValue, parseDateValue, relativeTimeValue } from './relative-time-model.js';

package/dist/index.js

@@ -8,6 +8,8 @@ import { Button, ButtonGroup } from "./components/Button.js";
 import { Input, InputGroup } from "./components/Input.js";
 import { Combobox } from "./components/Combobox.js";
 import { filterComboboxOptions } from "./combobox-model.js";
+import { SearchSuggest } from "./components/SearchSuggest.js";
+import { searchSegments, foldForSearch } from "./search-suggest-model.js";
 import { Textarea } from "./components/Textarea.js";
 import { Select } from "./components/Select.js";
 import { Checkbox } from "./components/Checkbox.js";
@@ -59,6 +61,7 @@ import { Progress } from "./components/Progress.js";
 import { Meter } from "./components/Meter.js";
 import { Stat } from "./components/Stat.js";
 import { Tooltip } from "./components/Tooltip.js";
+import { InfoTip } from "./components/InfoTip.js";
 import { EmptyState, ErrorState, ForbiddenState, NotFoundState, FilteredEmptyState, Skeleton, LoadingState } from "./components/States.js";
 import { RelativeTime } from "./components/RelativeTime.js";
 import { parseDateValue, relativeTimeValue } from "./relative-time-model.js";
@@ -202,6 +205,7 @@ export {
   InboxDetail,
   InboxItem,
   InboxList,
+  InfoTip,
   Input,
   InputGroup,
   Kanban,
@@ -246,6 +250,7 @@ export {
   SaveStatus,
   SavedViewMenu,
   SchedulingCalendar,
+  SearchSuggest,
   SectionHead,
   Segmented,
   SegmentedOption,
@@ -296,6 +301,7 @@ export {
   filterComboboxOptions,
   findRuleNodeDepth,
   flattenTree,
+  foldForSearch,
   hexToRgb,
   hsvToHex,
   hsvToRgb,
@@ -318,6 +324,7 @@ export {
   rgbToHex,
   rgbToHsv,
   ruleDepth,
+  searchSegments,
   selectRangeDate,
   startOfMonth,
   stepMetricValue,

package/dist/info-tip-model.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+
+/** Blank lines (any whitespace between two line breaks) separate paragraphs; empty paragraphs drop. */
+declare const helpParagraphs: (content: unknown) => string[];
+/** True when `help` would render an InfoTip, so a slot can skip its wrapper row. */
+declare const hasHelp: (help: unknown) => help is string;
+/** Default accessible name for a `help` slot: "About: <title>" for text titles. */
+declare const helpLabelFor: (thing: ReactNode) => string;
+
+export { hasHelp, helpLabelFor, helpParagraphs };

package/dist/info-tip-model.js

@@ -0,0 +1,8 @@
+const helpParagraphs = (content) => typeof content === "string" ? content.replace(/\r\n?/g, "\n").split(/\n\s*\n/).map((p) => p.trim()).filter(Boolean) : [];
+const hasHelp = (help) => helpParagraphs(help).length > 0;
+const helpLabelFor = (thing) => typeof thing === "string" || typeof thing === "number" ? `About: ${thing}` : "More information";
+export {
+  hasHelp,
+  helpLabelFor,
+  helpParagraphs
+};

package/dist/rich-text.cjs

@@ -1674,6 +1674,7 @@ var DEFAULT_RICH_TEXT_LABELS = {
   image: "Image",
   imageUploading: "Uploading image\u2026",
   imageFailed: "The image could not be added.",
+  imagesUnsupported: "Images can't be added here.",
   emoji: "Emoji",
   emojiSuggestions: "Emoji suggestions",
   undo: "Undo",
@@ -1685,8 +1686,9 @@ var DEFAULT_RICH_TEXT_LABELS = {
 var COMMON = ["bold", "italic", "strike", "code", "bulletList", "orderedList", "taskList", "blockquote", "codeBlock", "link", "emoji", "history", "source"];
 var PRESETS = {
   full: /* @__PURE__ */ new Set([...COMMON, "heading", "horizontalRule", "table", "image"]),
-  comment: new Set(COMMON),
-  template: /* @__PURE__ */ new Set([...COMMON, "heading", "horizontalRule", "table"])
+  // Images in every preset once the consumer supplies onUploadImage (TENSOR HAR-749).
+  comment: /* @__PURE__ */ new Set([...COMMON, "image"]),
+  template: /* @__PURE__ */ new Set([...COMMON, "heading", "horizontalRule", "table", "image"])
 };
 var emojiSuggestionKey = new import_state.PluginKey("uixEmojiSuggestion");
 var SHORTCODE_RE = /:([a-zA-Z0-9_+-]+):$/;
@@ -1802,7 +1804,8 @@ function RichTextEditor(props) {
     minRows,
     className,
     onBlur,
-    emojiImageBaseUrl
+    emojiImageBaseUrl,
+    imagesUnavailableReason
   } = props;
   const emojiBase = (0, import_react7.useMemo)(() => normalizeEmojiImageBaseUrl(emojiImageBaseUrl), [emojiImageBaseUrl]);
   const renderEmoji = useEmojiRenderer(emojiImageBaseUrl);
@@ -1814,7 +1817,7 @@ function RichTextEditor(props) {
   const linkPopoverId = `${uid}-link`;
   const controls = PRESETS[features];
   const has = (control) => controls.has(control) && (control !== "emoji" || emoji) && (control !== "image" || !!onUploadImage);
-  const latest = (0, import_react7.useRef)({ onChange, onSubmitShortcut, onBlur, isSafeUrl, resolveImageSrc, onUploadImage, placeholder, imagesOn: false });
+  const latest = (0, import_react7.useRef)({ onChange, onSubmitShortcut, onBlur, isSafeUrl, resolveImageSrc, onUploadImage, placeholder, imagesOn: false, imagesOffText: "" });
   latest.current = {
     onChange,
     onSubmitShortcut,
@@ -1823,7 +1826,8 @@ function RichTextEditor(props) {
     resolveImageSrc,
     onUploadImage,
     placeholder,
-    imagesOn: controls.has("image") && !!onUploadImage
+    imagesOn: controls.has("image") && !!onUploadImage,
+    imagesOffText: imagesUnavailableReason?.trim() || labels.imagesUnsupported
   };
   const lastValue = (0, import_react7.useRef)(value);
   const origin = (0, import_react7.useRef)(null);
@@ -2046,22 +2050,31 @@ function RichTextEditor(props) {
     shouldRerenderOnTransaction: false,
     editable: !disabled && !readOnly,
     editorProps: {
+      // An image file pasted or dropped where images are off used to vanish silently; now the
+      // status line says so (TENSOR HAR-749). A paste that also carries text is a text paste:
+      // Excel, Word and Docs add a PNG rendering of the copied cells or text, which must not
+      // replace (or block) the text itself.
       handlePaste: (_view, event) => {
-        const files = Array.from(event.clipboardData?.files ?? []).filter((f) => f.type.startsWith("image/"));
-        if (!files.length || !latest.current.imagesOn || !editorRef.current) return false;
-        files.forEach((file) => void uploadImage(editorRef.current, file));
+        const data = event.clipboardData;
+        const files = Array.from(data?.files ?? []).filter((f) => f.type.startsWith("image/"));
+        if (!files.length || !editorRef.current || data?.getData("text/plain").trim()) return false;
+        event.preventDefault();
+        if (!latest.current.imagesOn) setStatus({ kind: "notice", text: latest.current.imagesOffText });
+        else files.forEach((file) => void uploadImage(editorRef.current, file));
         return true;
       },
       handleDrop: (_view, event) => {
         const files = Array.from(event.dataTransfer?.files ?? []).filter((f) => f.type.startsWith("image/"));
-        if (!files.length || !latest.current.imagesOn || !editorRef.current) return false;
+        if (!files.length || !editorRef.current) return false;
         event.preventDefault();
-        files.forEach((file) => void uploadImage(editorRef.current, file));
+        if (!latest.current.imagesOn) setStatus({ kind: "notice", text: latest.current.imagesOffText });
+        else files.forEach((file) => void uploadImage(editorRef.current, file));
         return true;
       }
     },
     onCreate: ({ editor: ed }) => load(ed, lastValue.current),
     onUpdate: ({ editor: ed }) => {
+      setStatus((s) => s?.kind === "notice" ? null : s);
       if (!origin.current) return;
       emit(writeMarkdown(ed.getJSON(), origin.current, managerOf(ed)));
     },

package/dist/rich-text.d.cts

@@ -38,6 +38,8 @@ interface RichTextLabels {
     image: string;
     imageUploading: string;
     imageFailed: string;
+    /** Shown when an image is pasted or dropped where images are off (default for `imagesUnavailableReason`). */
+    imagesUnsupported: string;
     emoji: string;
     /** Accessible name of the `:shortcode` suggestion list. */
     emojiSuggestions: string;
@@ -64,11 +66,17 @@ interface RichTextEditorProps {
     features?: RichTextFeatures;
     /** Heading levels the toolbar and input rules offer. Default `[1, 2, 3]`. */
     headingLevels?: ReadonlyArray<RichTextHeadingLevel>;
-    /** Enables the image button (preset `full`), and image paste/drop. */
+    /** Enables image paste/drop and the toolbar image button, in every preset. */
     onUploadImage?: (file: File) => Promise<{
         src: string;
         alt: string;
     }>;
+    /**
+     * Shown in the status line when an image is pasted or dropped while images are off (no
+     * `onUploadImage`), e.g. "Attach files to the incident instead.". Nothing is inserted.
+     * Default: the `imagesUnsupported` label.
+     */
+    imagesUnavailableReason?: string;
     /** Link policy. Default: http(s), mailto and same-app paths. */
     isSafeUrl?: (url: string) => boolean;
     /** Image policy: the URL to display, or `null` to show the image as a link chip. */

package/dist/search-suggest-model.d.ts

@@ -0,0 +1,20 @@
+/** One run of a result's text, emphasised or not. */
+interface SearchSegment {
+    text: string;
+    match: boolean;
+}
+/** Text folded for matching, with a map back to the original characters. */
+interface FoldedText {
+    /** The folded text: lower case, diacritics stripped, ß → ss. */
+    text: string;
+    /** For each index of `text`, the start index of the original character it came from. */
+    source: number[];
+    /** For each index of `text`, the end index (exclusive) of that original character. */
+    sourceEnd: number[];
+}
+/** Fold `text` for matching and keep a map back to the original indices. */
+declare function foldForSearch(text: string): FoldedText;
+/** Split `text` into matched and unmatched segments for `query`. */
+declare function searchSegments(text: string, query: string): SearchSegment[];
+
+export { type FoldedText, type SearchSegment, foldForSearch, searchSegments };

package/dist/search-suggest-model.js

@@ -0,0 +1,74 @@
+const COMBINING_MARK = /\p{M}/u;
+function foldForSearch(text) {
+  let folded = "";
+  const source = [];
+  const sourceEnd = [];
+  let index = 0;
+  for (const char of text) {
+    const base = char === "\xDF" || char === "\u1E9E" ? "ss" : char.toLowerCase().normalize("NFD");
+    for (const part of base) {
+      if (COMBINING_MARK.test(part)) continue;
+      folded += part;
+      for (let i = 0; i < part.length; i += 1) {
+        source.push(index);
+        sourceEnd.push(index + char.length);
+      }
+    }
+    index += char.length;
+  }
+  return { text: folded, source, sourceEnd };
+}
+const isWordStart = (text, at) => at === 0 || /[\s\-_/.,:;()[\]'"›>·|]/u.test(text[at - 1] ?? "");
+function foldedRanges(haystack, query) {
+  const whole = query.trim();
+  if (!whole) return [];
+  const out = [];
+  let from = haystack.indexOf(whole);
+  if (from !== -1) {
+    while (from !== -1) {
+      out.push([from, from + whole.length]);
+      from = haystack.indexOf(whole, from + whole.length);
+    }
+    return out;
+  }
+  for (const token of whole.split(/\s+/)) {
+    for (let at = haystack.indexOf(token); at !== -1; at = haystack.indexOf(token, at + 1)) {
+      if (isWordStart(haystack, at)) out.push([at, at + token.length]);
+    }
+  }
+  return out;
+}
+function merge(ranges) {
+  const sorted = [...ranges].sort((a, b) => a[0] - b[0]);
+  const out = [];
+  for (const range of sorted) {
+    const last = out[out.length - 1];
+    if (last && range[0] <= last[1]) last[1] = Math.max(last[1], range[1]);
+    else out.push([range[0], range[1]]);
+  }
+  return out;
+}
+function searchSegments(text, query) {
+  const foldedQuery = foldForSearch(query).text;
+  if (!text || !foldedQuery.trim()) return [{ text, match: false }];
+  const folded = foldForSearch(text);
+  const ranges = merge(
+    foldedRanges(folded.text, foldedQuery).map(
+      ([start, end]) => [folded.source[start] ?? 0, folded.sourceEnd[end - 1] ?? text.length]
+    )
+  );
+  if (ranges.length === 0) return [{ text, match: false }];
+  const out = [];
+  let cursor = 0;
+  for (const [start, end] of ranges) {
+    if (start > cursor) out.push({ text: text.slice(cursor, start), match: false });
+    out.push({ text: text.slice(start, end), match: true });
+    cursor = end;
+  }
+  if (cursor < text.length) out.push({ text: text.slice(cursor), match: false });
+  return out;
+}
+export {
+  foldForSearch,
+  searchSegments
+};

package/package.json

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