@apliteni/apliteni-ui 0.129.0 → 0.131.0

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@apliteni/apliteni-ui",
-  "version": "0.129.0",
+  "version": "0.131.0",
+
   "workspaces": [
     "react"
   ],

package/react/README.md

@@ -585,6 +585,13 @@ or neutral. Notices disappear after five seconds, pausing while hovered or focus
 Danger notices are announced assertively; other tones are polite. An `action` with a `label` and
 `onClick` stays until selected or dismissed. New notices appear at the bottom.
 
+Pass `compact: true` to show only the title, or `dismissible: false` to hide the
+close button. Hiding the close button keeps the five-second timer for notices
+without actions; notices with actions remain until their action is selected, so a
+notice with an action and no close button has no other dismissal affordance.
+Pass `timer: 12` to dismiss a notice after that many seconds. Pass `timer: false` or `timer: 0`
+to keep a notice until it is dismissed.
+
 ```tsx
 function SaveButton() {
   const push = useToast();

package/react/dist/index.d.ts

@@ -68,6 +68,19 @@ declare function Badge({ variant, children }: {
     children: ReactNode;
 }): react.JSX.Element;
 
+type AvatarProps = {
+    /** The app's stable id for the person. It picks the hue, so one person keeps one hue. */
+    personKey?: string | number;
+    /** The person's name. The mark shows its first and last initials; empty draws the `user` glyph. */
+    name?: string | null;
+    /** A photo. The letters show if it fails to load. */
+    src?: string;
+    size?: 24 | 32;
+    /** A dashed ring in place of a person: no value, or a "No one" row. */
+    empty?: boolean;
+};
+declare function Avatar({ personKey, name, src, size, empty }: AvatarProps): react.JSX.Element;
+
 type PillProps = HTMLAttributes<HTMLSpanElement> & {
     variant?: 'live' | 'soon';
 };
@@ -416,6 +429,12 @@ type DropdownBadge = string | {
     text: string;
     tone?: string;
 };
+type DropdownAvatar = {
+    key?: string | number;
+    name?: string | null;
+    src?: string;
+    empty?: boolean;
+};
 type DropdownItem = {
     label: string;
     /** The pick, as `onSelect` reports it and as `data-value` carries it. */
@@ -423,6 +442,9 @@ type DropdownItem = {
     description?: string;
     /** A kit glyph name, drawn in the row's leading slot. */
     icon?: string;
+    /** A person's mark in the leading slot, in place of `icon`. `key` picks the hue, `name` the
+     *  letters, `src` a photo. `{ empty: true }` is the dashed ring of a "No one" row. */
+    avatar?: DropdownAvatar;
     badge?: DropdownBadge;
     selected?: boolean;
     disabled?: boolean;
@@ -451,6 +473,11 @@ type DropdownSearch = {
     hint?: string;
     /** What the field holds before it is opened; every open starts from the whole list. */
     query?: string;
+    /** The size of the whole set, for "Search 214 people" in the placeholder and the field's
+     *  name. `true` counts the rows, less a "No one" row. */
+    count?: number | true;
+    /** What the set is called in that line. Defaults to "people". */
+    noun?: string;
 };
 /**
  * What a row has to carry to be a row: the classes, the role, the tab stop the
@@ -778,6 +805,9 @@ declare const SearchField: react.ForwardRefExoticComponent<Omit<InputHTMLAttribu
 
 type ToastNotice = {
     tone?: 'success' | 'danger' | 'warn' | 'info' | 'neutral';
+    compact?: boolean;
+    dismissible?: boolean;
+    timer?: boolean | number;
     title: string;
     text?: string;
     action?: {
@@ -1118,4 +1148,4 @@ declare const Breadcrumbs: react.ForwardRefExoticComponent<Omit<Omit<react.Detai
 declare const PAGE_SIZES: readonly number[];
 declare const DEFAULT_PAGE_SIZE: number;
 
-export { type Accent, AccentPicker, type AccentPickerProps, type AddFilter, AppShell, type AppShellProps, type AppShellSection, BackLink, type BackLinkOwnProps, type BackLinkProps, Badge, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BusyRegion, type BusyRegionProps, Button, type ButtonLinkProps, type ButtonProps, Callout, type CalloutProps, type CalloutVariant, Card, Chart, type ChartBridgeStep, type ChartBridgeTones, type ChartPeriod, type ChartProps, type ChartSeries, type ChartTone, CheckList, type CheckListProps, Checkbox, type CheckboxProps, type Column, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, Confirm, type ConfirmProps, DEFAULT_PAGE_SIZE, DataTable, type DataTableProps, DatePicker, type DatePickerMode, type DatePickerPreset, type DatePickerProps, type DatePickerRange, DeltaValue, type DeltaValueProps, Denied, type DeniedProps, Drawer, type DrawerProps, DrawerSection, type DrawerSectionProps, Dropdown, type DropdownBadge, type DropdownEntry, type DropdownItem, type DropdownProps, type DropdownRowProps, type DropdownSearch, type DropdownSection, type DropdownSeparator, EmptyState, type EmptyStateProps, type EmptyStateVariant, Field, type FieldControlProps, type FieldProps, FileDrop, type FileDropFile, type FileDropProps, type FileDropStatus, FileField, type FileFieldProps, type Filter, FilterBar, type FilterBarProps, Icon, KeyValueList, type KeyValueListProps, type KeyValueRow, Modal, type ModalProps, type NativeButtonProps, type NavTabBadge, type NavTabItem, NavTabs, type NavTabsProps, NumericValue, type NumericValueProps, PAGE_SIZES, Pagination, type PaginationProps, Pill, type PillProps, RowIdentity, type RowIdentityProps, SearchField, type SearchFieldProps, type SegmentOption, Segmented, type SegmentedProps, SelectField, type SelectFieldProps, SidebarNav, type SidebarNavBadge, type SidebarNavItem, type SidebarNavLeaf, type SidebarNavProps, type SidebarNavSection, Skeleton, type SkeletonProps, SkeletonTable, type SkeletonTableProps, Snippet, type SnippetProps, StatBand, type StatBandProps, type StatDelta, type StatFigure, type StatTone, type StatVariant, StatusDot, type StatusDotProps, Success, SuccessCheck, type SuccessCheckProps, type SuccessCountdown, SuccessPanel, type SuccessPanelProps, type SuccessProps, Switch, type SwitchProps, THEME_INIT_SCRIPT, type TabItem, type TableSort, Tabs, type TabsProps, TextArea, type TextAreaProps, TextField, type TextFieldProps, ThemeToggle, type ThemeToggleProps, Timeline, type TimelineEvent, type TimelineEventKind, type TimelineProps, Toast, type ToastNotice, type ToastProps, Tooltip, type TooltipProps, sortTableRows, useToast };
+export { type Accent, AccentPicker, type AccentPickerProps, type AddFilter, AppShell, type AppShellProps, type AppShellSection, Avatar, type AvatarProps, BackLink, type BackLinkOwnProps, type BackLinkProps, Badge, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, BusyRegion, type BusyRegionProps, Button, type ButtonLinkProps, type ButtonProps, Callout, type CalloutProps, type CalloutVariant, Card, Chart, type ChartBridgeStep, type ChartBridgeTones, type ChartPeriod, type ChartProps, type ChartSeries, type ChartTone, CheckList, type CheckListProps, Checkbox, type CheckboxProps, type Column, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, Confirm, type ConfirmProps, DEFAULT_PAGE_SIZE, DataTable, type DataTableProps, DatePicker, type DatePickerMode, type DatePickerPreset, type DatePickerProps, type DatePickerRange, DeltaValue, type DeltaValueProps, Denied, type DeniedProps, Drawer, type DrawerProps, DrawerSection, type DrawerSectionProps, Dropdown, type DropdownAvatar, type DropdownBadge, type DropdownEntry, type DropdownItem, type DropdownProps, type DropdownRowProps, type DropdownSearch, type DropdownSection, type DropdownSeparator, EmptyState, type EmptyStateProps, type EmptyStateVariant, Field, type FieldControlProps, type FieldProps, FileDrop, type FileDropFile, type FileDropProps, type FileDropStatus, FileField, type FileFieldProps, type Filter, FilterBar, type FilterBarProps, Icon, KeyValueList, type KeyValueListProps, type KeyValueRow, Modal, type ModalProps, type NativeButtonProps, type NavTabBadge, type NavTabItem, NavTabs, type NavTabsProps, NumericValue, type NumericValueProps, PAGE_SIZES, Pagination, type PaginationProps, Pill, type PillProps, RowIdentity, type RowIdentityProps, SearchField, type SearchFieldProps, type SegmentOption, Segmented, type SegmentedProps, SelectField, type SelectFieldProps, SidebarNav, type SidebarNavBadge, type SidebarNavItem, type SidebarNavLeaf, type SidebarNavProps, type SidebarNavSection, Skeleton, type SkeletonProps, SkeletonTable, type SkeletonTableProps, Snippet, type SnippetProps, StatBand, type StatBandProps, type StatDelta, type StatFigure, type StatTone, type StatVariant, StatusDot, type StatusDotProps, Success, SuccessCheck, type SuccessCheckProps, type SuccessCountdown, SuccessPanel, type SuccessPanelProps, type SuccessProps, Switch, type SwitchProps, THEME_INIT_SCRIPT, type TabItem, type TableSort, Tabs, type TabsProps, TextArea, type TextAreaProps, TextField, type TextFieldProps, ThemeToggle, type ThemeToggleProps, Timeline, type TimelineEvent, type TimelineEventKind, type TimelineProps, Toast, type ToastNotice, type ToastProps, Tooltip, type TooltipProps, sortTableRows, useToast };