feat(island): v6 compositions — list rows, page header, section title, pinned footer, result panel, stat tile, meter, search field, avatar stack, timeline, code input, key-value, analyst card; new chips, segmented, avatar sizes, toast placement, account menu items, post and prediction card names and close reason

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Amiram_se 2026-10-09 17:38:43 +04:00
parent e5c7ec54d7
commit c6c1aa33b2
122 changed files with 3227 additions and 247 deletions

View File

@ -5,23 +5,26 @@ import type { AvatarSize } from './types';
export const AVATAR_PX: Record<AvatarSize, number> = {
sm: 32,
md: 40,
lg: 56,
xl: 80,
lg: 52,
xl: 72,
'2xl': 96,
xxl: 96,
};
export const AVATAR_INITIAL_VARIANT: Record<AvatarSize, TypographyVariant> = {
sm: 'label',
md: 'body-md',
lg: 'heading-sm',
lg: 'heading-md',
xl: 'heading-lg',
'2xl': 'display',
xxl: 'display',
};
export const AVATAR_MARK_PX: Record<AvatarSize, number> = {
sm: 12,
md: 14,
lg: 18,
xl: 22,
xl: 20,
'2xl': 24,
xxl: 24,
};

View File

@ -10,12 +10,14 @@ export const avatarVariants = cva(
sm: 'size-8',
/** Post headers, subscription cards, list rows. */
md: 'size-10',
/** Sheet and checkout headers. */
lg: 'size-14',
/** The channel profile header. */
xl: 'size-20',
/** The profile photo field. */
/** Analyst cards, sheet and checkout headers (DS lg, 52px). */
lg: 'size-13',
/** The channel header (DS xl, 72px). */
xl: 'size-18',
/** The profile photo field (96px). */
'2xl': 'size-24',
/** The DS name for `2xl` (96px). */
xxl: 'size-24',
},
/** An account that can't be used, such as a suspended creator's own avatar: no brand colour. */
muted: {

View File

@ -27,7 +27,7 @@ export function Chip({
{...props}
>
{selected && <Icon name="check" size={16} strokeWidth={2.5} />}
<Typography tag="span" variant="label" color="inherit">
<Typography tag="span" variant="inherit" color="inherit">
{children}
</Typography>
</FlexBox>

View File

@ -1,3 +1,3 @@
export { Chip } from './Chip';
export type { ChipProps, ChipSize } from './types';
export { chipVariants } from './variants';
export { chipRowVariants, chipVariants } from './variants';

View File

@ -1,20 +1,35 @@
import { cva } from 'class-variance-authority';
/** A pill you press to pick one of many, such as a market; a set sits in a wrapping row. */
/**
* A pill you press to pick one of many, such as a market; a set sits in a wrapping row (DS Chips).
* Off, it is white with a `border-default` outline; on, filled brand. 15/600, 14 at `sm`.
*/
export const chipVariants = cva(
'rounded-full border px-4 whitespace-nowrap transition-colors duration-120 ease-standard focus-visible:focus-ring actionable:cursor-pointer disabled:frozen',
'rounded-full border px-4 font-semibold whitespace-nowrap transition-colors duration-120 ease-standard focus-visible:focus-ring actionable:cursor-pointer disabled:frozen',
{
variants: {
selected: {
true: 'border-action-primary bg-action-primary text-text-on-action actionable:hover:bg-action-primary-hover',
false:
'border-transparent bg-action-primary-muted text-action-primary-text actionable:hover:border-action-primary',
'border-border-default bg-surface text-text-primary actionable:hover:border-text-secondary actionable:hover:bg-surface-hover',
},
size: {
sm: 'min-h-control-sm px-3.5',
md: 'min-h-control-md',
sm: 'min-h-control-sm px-3.5 text-body-sm leading-6',
md: 'min-h-control-md text-[0.9375rem] leading-6',
},
},
defaultVariants: { selected: false, size: 'md' },
},
);
/** A set of chips: wrapping rows, or one row that scrolls sideways (DS `scroll`). */
export const chipRowVariants = cva('', {
variants: {
scroll: {
// The 4px padding keeps each chip's focus ring inside the scroller's clip.
true: '-m-1 overflow-x-auto p-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden',
false: '',
},
},
defaultVariants: { scroll: false },
});

View File

@ -18,14 +18,17 @@ export const ICON_NAMES = [
'chevron-down',
'chevron-left',
'chevron-right',
'chevron-up',
'clock',
'close',
'copy',
'dashboard',
'download',
'edit',
'expand',
'external',
'eye',
'file',
'filter',
'flag',
'grip',
@ -43,12 +46,16 @@ export const ICON_NAMES = [
'minus',
'more',
'pause',
'phone',
'plus-square',
'plus',
'receipt',
'refresh',
'search-x',
'search',
'server',
'settings',
'share-ios',
'share',
'shield-check',
'sort',

View File

@ -8,12 +8,14 @@ import { Typography } from '../typography';
import type { SelectProps } from './types';
/**
* A labelled native select, 44px high. On phones the system draws its own wheel or list, so a
* date or time picker built from these needs no script of its own.
* A labelled native select with the DS SelectField look: 48px, 16px padding, an optional leading
* icon and the chevron at the end. On phones the system draws its own wheel or list, so a date or
* time picker built from these needs no script of its own (0035).
*/
export function Select({
label,
options,
icon,
className,
id,
...props
@ -36,10 +38,19 @@ export function Select({
{label}
</Typography>
<FlexBox tag="span" alignItems="items-center" className="relative">
{icon && (
<Icon
name={icon}
className="pointer-events-none absolute start-4 text-text-secondary"
/>
)}
<Element
tag="select"
id={selectId}
className="h-touch-target w-full cursor-pointer appearance-none rounded-md border border-border-default bg-surface ps-3 pe-8 text-body-md text-text-primary outline-none transition-colors duration-120 ease-standard hover:border-border-strong focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-(--opacity-dimmed)"
className={cn(
'h-input-height w-full cursor-pointer appearance-none rounded-md border border-border-default bg-surface ps-4 pe-11 text-body-md text-text-primary outline-none transition-colors duration-120 ease-standard hover:border-text-secondary focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-(--opacity-dimmed)',
icon && 'ps-11',
)}
{...props}
>
{options.map((option) => (
@ -50,8 +61,7 @@ export function Select({
</Element>
<Icon
name="chevron-down"
size={16}
className="pointer-events-none absolute end-3 text-text-secondary"
className="pointer-events-none absolute end-4 text-text-secondary"
/>
</FlexBox>
</FlexBox>

View File

@ -1,9 +1,13 @@
import type { ComponentPropsWithRef, ReactNode } from 'react';
import type { IconName } from '../icon';
export type SelectOption = { value: string; label: ReactNode };
export type SelectProps = Omit<ComponentPropsWithRef<'select'>, 'children'> & {
/** The visible label above the control, such as «روز». */
label: ReactNode;
options: readonly SelectOption[];
/** A 20px icon at the start of the control, such as `clock` (DS SelectField). */
icon?: IconName;
};

View File

@ -1,7 +1,10 @@
'use client';
import { useId } from 'react';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import { FlexBox } from '../flex-box';
import { Typography } from '../typography';
import type { SwitchProps } from './types';
import { switchKnobVariants, switchTrackVariants } from './variants';
@ -16,10 +19,15 @@ export function Switch({
onCheckedChange,
locked = false,
children,
description,
className,
onClick,
...props
}: SwitchProps) {
const labelId = useId();
const descriptionId = useId();
const hasText = children != null || description != null;
return (
<Element
tag="button"
@ -27,6 +35,11 @@ export function Switch({
role="switch"
aria-checked={checked}
aria-disabled={locked || undefined}
// The label alone names it; the description is announced after it, not inside the name.
aria-labelledby={
children != null && description != null ? labelId : undefined
}
aria-describedby={description != null ? descriptionId : undefined}
onClick={(event) => {
onClick?.(event);
if (!locked && !event.defaultPrevented) onCheckedChange?.(!checked);
@ -36,15 +49,38 @@ export function Switch({
locked
? 'cursor-not-allowed opacity-(--opacity-dimmed)'
: 'cursor-pointer',
children && 'justify-between text-start',
hasText && 'justify-between text-start',
className,
)}
{...props}
>
{children && (
<Typography tag="span" variant="body-sm" className="font-semibold">
{children}
</Typography>
{hasText && (
<FlexBox
tag="span"
direction="flex-col"
className="min-w-0 flex-1 gap-0.5"
>
{children != null && (
<Typography
tag="span"
id={labelId}
variant="body-sm"
className="font-semibold"
>
{children}
</Typography>
)}
{description != null && (
<Typography
tag="span"
id={descriptionId}
variant="caption"
color="secondary"
>
{description}
</Typography>
)}
</FlexBox>
)}
<Element
tag="span"

View File

@ -11,6 +11,11 @@ export type SwitchProps = Omit<
* Without it, give the switch an `aria-label`.
*/
children?: ReactNode;
/**
* A muted caption under the label, such as what turning it on does (DS Switch `description`).
* Read out as the switch's description.
*/
description?: ReactNode;
/** Can't change now, such as a period during the 7-day lock: 50%, `aria-disabled`, still focusable. */
locked?: boolean;
};

View File

@ -6,7 +6,7 @@
* Raise it with every change to `icons/*.svg` or to the svgo step in `icon-sprite-plugin`, in the
* same commit. Never reuse or lower it.
*/
export const ICON_SPRITE_VERSION = 1;
export const ICON_SPRITE_VERSION = 2;
/** Where `icon-sprite-plugin` writes the sprite, under each app's `public/`. Its name never changes. */
export const ICON_SPRITE_PATH = '/icons/symbol-defs.svg';

View File

@ -0,0 +1,3 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<path d="M6 15l6-6 6 6" />
</svg>

After

Width:  |  Height:  |  Size: 198 B

View File

@ -0,0 +1,3 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<path d="M4 9V4h5M20 9V4h-5M4 15v5h5M20 15v5h-5" />
</svg>

After

Width:  |  Height:  |  Size: 223 B

View File

@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<path d="M6 3h8l4 4v14H6z" />
<path d="M14 3v4h4M9 12h6M9 16h6" />
</svg>

After

Width:  |  Height:  |  Size: 240 B

View File

@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<rect x="6.5" y="2.5" width="11" height="19" rx="2.5" />
<path d="M10.5 18.5h3" />
</svg>

After

Width:  |  Height:  |  Size: 256 B

View File

@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<rect x="3.5" y="3.5" width="17" height="17" rx="3" />
<path d="M12 8v8M8 12h8" />
</svg>

After

Width:  |  Height:  |  Size: 256 B

View File

@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<circle cx="12" cy="12" r="3" />
<path d="M12 2.5v3M12 18.5v3M2.5 12h3M18.5 12h3M5.3 5.3l2.1 2.1M16.6 16.6l2.1 2.1M5.3 18.7l2.1-2.1M16.6 7.4l2.1-2.1" />
</svg>

After

Width:  |  Height:  |  Size: 326 B

View File

@ -0,0 +1,4 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round">
<path d="M12 3v12M8 7l4-4 4 4" />
<path d="M8.5 10H6a1 1 0 0 0-1 1v9a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-9a1 1 0 0 0-1-1h-2.5" />
</svg>

After

Width:  |  Height:  |  Size: 299 B

View File

@ -11,7 +11,7 @@ export type {
} from './atoms/button';
export { Checkbox, checkboxVariants } from './atoms/checkbox';
export type { CheckboxProps } from './atoms/checkbox';
export { Chip, chipVariants } from './atoms/chip';
export { Chip, chipRowVariants, chipVariants } from './atoms/chip';
export type { ChipProps, ChipSize } from './atoms/chip';
export { CountBadge } from './atoms/count-badge';
export type { CountBadgeProps } from './atoms/count-badge';
@ -109,6 +109,15 @@ export type {
TypographyProps,
TypographyVariant,
} from './atoms/typography';
export {
AvatarStack,
avatarStackFaceVariants,
avatarStackVariants,
} from './molecules/avatar-stack';
export type {
AvatarStackItem,
AvatarStackProps,
} from './molecules/avatar-stack';
export { AvatarField } from './molecules/avatar-field';
export type {
AvatarFieldLabels,
@ -125,8 +134,19 @@ export { ChipGroup } from './molecules/chip-group';
export type { ChipGroupOption, ChipGroupProps } from './molecules/chip-group';
export { ChoiceCard, choiceCardVariants } from './molecules/choice-card';
export type { ChoiceCardProps } from './molecules/choice-card';
export { DetailRow, detailRowVariants } from './molecules/detail-row';
export type { DetailRowProps } from './molecules/detail-row';
export {
DetailRow,
detailRowVariants,
detailValueVariants,
} from './molecules/detail-row';
export type { DetailRowProps, DetailRowTone } from './molecules/detail-row';
export { CodeInput, codeInputButtonVariants } from './molecules/code-input';
export type {
CodeInputLabels,
CodeInputProps,
CodeInputSource,
CodeInputStatus,
} from './molecules/code-input';
export { EmptyState } from './molecules/empty-state';
export type { EmptyStateProps, EmptyStateTone } from './molecules/empty-state';
export { ERROR_KIND_STYLES, ErrorState } from './molecules/error-state';
@ -142,10 +162,31 @@ export { FormSection } from './molecules/form-section';
export type { FormSectionProps } from './molecules/form-section';
export { InfoTip, infoTipVariants } from './molecules/info-tip';
export type { InfoTipProps } from './molecules/info-tip';
export { KeyValue, keyValueVariants } from './molecules/key-value';
export type { KeyValueProps, KeyValueTone } from './molecules/key-value';
export {
List,
ListRow,
listHeaderVariants,
listItemsVariants,
listRowIconVariants,
listRowVariants,
listVariants,
} from './molecules/list-row';
export type {
ListProps,
ListRowAsButtonProps,
ListRowAsLinkProps,
ListRowIconTone,
ListRowProps,
ListTone,
} from './molecules/list-row';
export { LockedTeaser } from './molecules/locked-teaser';
export type { LockedTeaserProps } from './molecules/locked-teaser';
export { MediaCarousel } from './molecules/media-carousel';
export type { MediaCarouselProps, MediaItem } from './molecules/media-carousel';
export { Meter, meterBarVariants } from './molecules/meter';
export type { MeterProps, MeterTone } from './molecules/meter';
export { Modal } from './molecules/modal';
export type { ModalProps, ModalSize } from './molecules/modal';
export {
@ -157,6 +198,17 @@ export type {
NetworkStatusProps,
} from './molecules/network-status';
export { OtpInput } from './molecules/otp-input';
export { PageHeader, pageHeaderTitleVariants } from './molecules/page-header';
export type { PageHeaderProps, PageHeaderSize } from './molecules/page-header';
export {
PINNED_FOOTER_TOAST_OFFSET,
PinnedFooter,
pinnedFooterVariants,
} from './molecules/pinned-footer';
export type {
PinnedFooterLayout,
PinnedFooterProps,
} from './molecules/pinned-footer';
export type { OtpInputProps, OtpStatus } from './molecules/otp-input';
export { ResendCode } from './molecules/resend-code';
export type {
@ -164,13 +216,30 @@ export type {
ResendCodeProps,
ResendStatus,
} from './molecules/resend-code';
export {
RESULT_PANEL_ICONS,
ResultPanel,
resultPanelIconVariants,
} from './molecules/result-panel';
export type {
ResultPanelProps,
ResultPanelTone,
} from './molecules/result-panel';
export { SampleFrame, sampleTagVariants } from './molecules/sample-frame';
export {
SearchField,
searchFieldInputVariants,
searchFieldVariants,
} from './molecules/search-field';
export type { SearchFieldProps } from './molecules/search-field';
export type { SampleFrameProps } from './molecules/sample-frame';
export {
SectionHeading,
sectionHeadingVariants,
} from './molecules/section-heading';
export type { SectionHeadingProps } from './molecules/section-heading';
export { SectionTitle, sectionTitleVariants } from './molecules/section-title';
export type { SectionTitleProps } from './molecules/section-title';
export {
SegmentedChoice,
segmentedChoiceOptionVariants,
@ -180,6 +249,7 @@ export type {
SegmentedChoiceOption,
SegmentedChoiceProps,
SegmentedChoiceSize,
SegmentedChoiceTone,
SegmentedChoiceTrack,
} from './molecules/segmented-choice';
export { Sheet } from './molecules/sheet';
@ -189,9 +259,31 @@ export type {
StateMessageProps,
StateMessageSize,
} from './molecules/state-message';
export {
StatTile,
statTileValueVariants,
statTileVariants,
} from './molecules/stat-tile';
export type {
StatTileProps,
StatTileTone,
StatTileValueTone,
} from './molecules/stat-tile';
export { StepProgress } from './molecules/step-progress';
export type { StepProgressProps } from './molecules/step-progress';
export { TabLinks } from './molecules/tab-links';
export {
Timeline,
TimelineItem,
timelineDotVariants,
timelineItemVariants,
timelineVariants,
} from './molecules/timeline';
export type {
TimelineItemProps,
TimelineProps,
TimelineTone,
} from './molecules/timeline';
export type { TabLinkItem, TabLinksProps } from './molecules/tab-links';
export {
TextInput,
@ -199,14 +291,32 @@ export {
textInputControlVariants,
} from './molecules/text-input';
export type { TextInputProps } from './molecules/text-input';
export { dismissToast, showToast, Toast, Toaster } from './molecules/toast';
export {
dismissToast,
showToast,
Toast,
TOAST_OFFSETS,
Toaster,
ToastPlacementMarker,
useToastPlacement,
} from './molecules/toast';
export type {
DeclaredToastPlacement,
ShowToastOptions,
ToastAction,
ToasterProps,
ToastPlacement,
ToastPlacementMarkerProps,
ToastProps,
ToastTone,
} from './molecules/toast';
export { AnalystCard } from './organisms/analyst-card';
export type {
AnalystCardAnalyst,
AnalystCardLabels,
AnalystCardProps,
AnalystCardStats,
} from './organisms/analyst-card';
export { CreatorStats } from './organisms/creator-stats';
export type {
CreatorStatsData,
@ -233,6 +343,7 @@ export { PredictionCard } from './organisms/prediction-card';
export type {
PredictionCardLabels,
PredictionCardProps,
PredictionCloseReason,
PredictionData,
PredictionDirection,
PredictionOutcome,

View File

@ -3,6 +3,7 @@
import { useEffect, useEffectEvent, useRef } from 'react';
import type { KeyboardEvent } from 'react';
import { FlexBox } from '../../atoms/flex-box';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import { ActionMenuItem } from './components/ActionMenuItem';
@ -11,8 +12,9 @@ import { actionMenuVariants } from './variants';
/**
* A short list of destinations or actions anchored to its trigger, such as «انتشار» → «پست جدید»
* / «پیش‌بینی جدید», or a post's share → «کپی لینک». Put it in a positioned container that holds
* only the trigger and the menu, and give the trigger `aria-haspopup="menu"`. It takes focus when
* / «پیش‌بینی جدید», a post's share → «کپی لینک», or the desktop account menu with its identity
* `header`, links and a danger «خروج از حساب» after a separator. Put it in a positioned container
* that holds only the trigger and the menu, and give the trigger `aria-haspopup="menu"`. It takes focus when
* it opens; ↑ ↓ move, and the trigger keeps its own press. Escape or a choice closes it and puts
* focus back on that container's `[aria-haspopup]` trigger; a press outside, or Tab out of the
* menu and its trigger, closes it and leaves focus where the press or Tab put it.
@ -22,10 +24,11 @@ export function ActionMenu({
onClose,
items,
label,
header,
placement = 'below',
className,
}: ActionMenuProps) {
const ref = useRef<HTMLUListElement>(null);
const ref = useRef<HTMLDivElement>(null);
const close = useEffectEvent(onClose);
useEffect(() => {
@ -61,7 +64,7 @@ export function ActionMenu({
trigger?.focus();
};
const onKeyDown = (event: KeyboardEvent<HTMLUListElement>) => {
const onKeyDown = (event: KeyboardEvent<HTMLElement>) => {
const options = Array.from(
ref.current?.querySelectorAll<HTMLElement>('[role="menuitem"]') ?? [],
);
@ -79,19 +82,33 @@ export function ActionMenu({
return (
<Element
ref={ref}
tag="ul"
role="menu"
aria-label={label}
onKeyDown={onKeyDown}
tag="div"
className={cn(actionMenuVariants({ placement }), className)}
>
{items.map((item) => (
<ActionMenuItem
key={item.href ?? item.label}
{...item}
onClose={closeToTrigger}
/>
))}
{header != null && (
<FlexBox
alignItems="items-center"
gap="gap-3"
className="mb-1.5 border-b border-border-subtle px-3 pt-2 pb-3"
>
{header}
</FlexBox>
)}
<Element
tag="ul"
role="menu"
aria-label={label}
onKeyDown={onKeyDown}
className="m-0"
>
{items.map((item) => (
<ActionMenuItem
key={item.href ?? item.label}
{...item}
onClose={closeToTrigger}
/>
))}
</Element>
</Element>
);
}

View File

@ -6,19 +6,19 @@ import { Typography } from '../../../atoms/typography';
import { Element } from '../../../primitives/element';
import { cn } from '../../../tools/cn';
import type { ActionMenuItemProps } from '../types';
/** A link row and a button row look the same. */
const ROW_CLASS =
'min-h-touch-target rounded-md px-3 text-text-primary no-underline outline-none hover:bg-surface-sunken focus-visible:bg-surface-sunken focus-visible:focus-ring';
import { actionMenuIconVariants, actionMenuItemVariants } from '../variants';
/**
* One destination or action: its icon in the brand colour and its name, a 44px row. A link
* navigates; a button closes the menu, then runs its `onSelect`.
* One destination or action: its icon in the brand colour (red on a danger item) and its name, a
* 48px row. A link navigates; a button closes the menu, then runs its `onSelect`. A separator
* before it starts a new group.
*/
export function ActionMenuItem({
href,
label,
icon,
tone = 'default',
separatorBefore = false,
onSelect,
onClose,
}: ActionMenuItemProps) {
@ -27,44 +27,52 @@ export function ActionMenuItem({
<Icon
name={icon}
size={20}
className="flex-none text-action-primary-text"
className={actionMenuIconVariants({ tone })}
/>
<Typography tag="span" color="inherit" className="font-semibold">
{label}
</Typography>
</>
);
const rowClass = actionMenuItemVariants({ tone });
return (
<Element tag="li" role="none">
{href != null ? (
<FlexBox
tag={NextLink}
href={href}
role="menuitem"
onClick={onClose}
alignItems="items-center"
gap="gap-3"
className={ROW_CLASS}
>
{content}
</FlexBox>
) : (
<FlexBox
tag="button"
type="button"
role="menuitem"
onClick={() => {
onClose();
onSelect?.();
}}
alignItems="items-center"
gap="gap-3"
className={cn(ROW_CLASS, 'w-full cursor-pointer text-start')}
>
{content}
</FlexBox>
<>
{separatorBefore && (
<Element tag="li" role="none">
<Element tag="hr" className="my-1.5 h-px border-0 bg-border-subtle" />
</Element>
)}
</Element>
<Element tag="li" role="none">
{href != null ? (
<FlexBox
tag={NextLink}
href={href}
role="menuitem"
onClick={onClose}
alignItems="items-center"
gap="gap-3"
className={rowClass}
>
{content}
</FlexBox>
) : (
<FlexBox
tag="button"
type="button"
role="menuitem"
onClick={() => {
onClose();
onSelect?.();
}}
alignItems="items-center"
gap="gap-3"
className={cn(rowClass, 'cursor-pointer')}
>
{content}
</FlexBox>
)}
</Element>
</>
);
}

View File

@ -1,9 +1,15 @@
import type { ReactNode } from 'react';
import type { IconName } from '../../atoms/icon';
/** A destination (`href`, a link) or an action (`onSelect`, a button), never both. */
export type ActionMenuItem = {
label: string;
icon: IconName;
/** danger: a destructive choice in red, such as «خروج از حساب». */
tone?: 'default' | 'danger';
/** A hairline above the item, which starts a new group, such as sign-out under the links. */
separatorBefore?: boolean;
} & (
| { href: string; onSelect?: never }
| {
@ -20,6 +26,11 @@ export type ActionMenuProps = {
items: readonly ActionMenuItem[];
/** The menu's accessible name, such as «انتشار». */
label: string;
/**
* Shown above the items over a hairline, never focused: who the menu belongs to, such as the
* account's avatar, name and @username.
*/
header?: ReactNode;
/** above: over a bottom-nav button. below: under a header button. */
placement?: 'above' | 'below';
className?: string;

View File

@ -2,7 +2,7 @@ import { cva } from 'class-variance-authority';
/** A card that hangs off its trigger: centred over it, or under it at the inline end. */
export const actionMenuVariants = cva(
'absolute z-menu m-0 min-w-55 rounded-lg border border-border-subtle bg-surface-raised p-1 shadow-2',
'absolute z-menu min-w-55 rounded-lg border border-border-subtle bg-surface-raised p-1.5 shadow-2',
{
variants: {
placement: {
@ -13,3 +13,28 @@ export const actionMenuVariants = cva(
defaultVariants: { placement: 'below' },
},
);
/** A 48px row, 16/600; a link row and a button row look the same. */
export const actionMenuItemVariants = cva(
'min-h-12 w-full rounded-md px-3 text-start no-underline outline-none hover:bg-surface-sunken focus-visible:bg-surface-sunken focus-visible:focus-ring',
{
variants: {
tone: {
default: 'text-text-primary',
danger: 'text-danger-text',
},
},
defaultVariants: { tone: 'default' },
},
);
/** The item's icon: the brand colour, or red on a danger item. */
export const actionMenuIconVariants = cva('flex-none', {
variants: {
tone: {
default: 'text-action-primary-text',
danger: 'text-danger-text',
},
},
defaultVariants: { tone: 'default' },
});

View File

@ -0,0 +1,113 @@
import { number } from '@lumina/tools/format';
import NextLink from 'next/link';
import { Avatar } from '../../atoms/avatar';
import { FlexBox } from '../../atoms/flex-box';
import { GridBox } from '../../atoms/grid-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import type { AvatarStackProps } from './types';
import { avatarStackFaceVariants, avatarStackVariants } from './variants';
/**
* Overlapping 32px avatars with «+N» for the rest (DS AvatarStack). With a `title` it is the strip
* on خانه, «تحلیلگران منتخب», and with `href` the whole strip is a link.
*/
export function AvatarStack({
avatars,
max = 4,
title,
subtitle,
href,
label,
className,
}: AvatarStackProps) {
const shown = avatars.slice(0, max);
const rest = avatars.length - shown.length;
const strip = title != null;
const faces = (
<FlexBox
tag="span"
display="inline-flex"
alignItems="items-center"
role={!strip && label ? 'img' : undefined}
aria-label={!strip ? label : undefined}
aria-hidden={strip || !label ? true : undefined}
className={cn('flex-none', !strip && className)}
>
{shown.map((avatar, index) => (
<Avatar
key={avatar.name}
name={avatar.name}
src={avatar.src}
size="sm"
className={avatarStackFaceVariants({ overlap: index > 0 })}
/>
))}
{rest > 0 && (
<GridBox
tag="span"
justifyItems="justify-items-center"
alignItems="items-center"
className={cn(
avatarStackFaceVariants({ overlap: shown.length > 0 }),
'size-8 bg-surface-sunken text-text-secondary',
)}
>
<Typography
tag="bdi"
dir="ltr"
variant="micro"
color="inherit"
className="font-semibold"
>
{`+${number(rest)}`}
</Typography>
</GridBox>
)}
</FlexBox>
);
if (!strip) return faces;
const content = (
<>
{faces}
<FlexBox tag="span" direction="flex-col" className="min-w-0 flex-1">
<Typography tag="span" className="font-semibold">
{title}
</Typography>
{subtitle != null && (
<Typography tag="span" variant="caption" color="secondary">
{subtitle}
</Typography>
)}
</FlexBox>
{href && (
<Icon name="chevron-left" size={20} className="text-text-tertiary" />
)}
</>
);
const classes = cn(
avatarStackVariants({ strip: true, link: href != null }),
className,
);
return href ? (
<FlexBox
tag={NextLink}
href={href}
alignItems="items-center"
gap="gap-3"
className={classes}
>
{content}
</FlexBox>
) : (
<FlexBox alignItems="items-center" gap="gap-3" className={classes}>
{content}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { AvatarStack } from './AvatarStack';
export type { AvatarStackItem, AvatarStackProps } from './types';
export { avatarStackFaceVariants, avatarStackVariants } from './variants';

View File

@ -0,0 +1,23 @@
import type { ReactNode } from 'react';
export type AvatarStackItem = {
/** The username: unique in the stack, and the placeholder's letter. */
name: string;
src?: string | null;
};
export type AvatarStackProps = {
/** In order; the first `max` show, the rest count as «+N». */
avatars: readonly AvatarStackItem[];
/** 4 by default. */
max?: number;
/** Makes it the DS strip, such as «تحلیلگران منتخب». */
title?: ReactNode;
/** Under the title, such as «۱۲ تحلیلگر فعال». */
subtitle?: ReactNode;
/** The strip opens this page, with a chevron. */
href?: string;
/** The faces' accessible name when there is no title, such as «۵ مشترک». */
label?: string;
className?: string;
};

View File

@ -0,0 +1,27 @@
import { cva } from 'class-variance-authority';
/**
* With a title, the DS AvatarStack strip: a bordered radius-lg row, at least 56px, that opens a
* list as a link. Without one, only the faces.
*/
export const avatarStackVariants = cva('min-w-0', {
variants: {
strip: {
true: 'min-h-14 rounded-lg border border-border-subtle bg-surface px-4 py-2 text-text-primary no-underline',
false: '',
},
link: {
true: 'transition-[border-color,box-shadow] duration-120 ease-standard focus-visible:focus-ring hover:border-border-strong hover:shadow-1',
false: '',
},
},
defaultVariants: { strip: false, link: false },
});
/** One 32px face, ringed in the surface so overlapping faces stay apart; each after the first tucks 10px under. */
export const avatarStackFaceVariants = cva('rounded-full ring-2 ring-surface', {
variants: {
overlap: { true: '-ms-2.5', false: '' },
},
defaultVariants: { overlap: false },
});

View File

@ -1,8 +1,9 @@
import { useId } from 'react';
import { Chip } from '../../atoms/chip';
import { Chip, chipRowVariants } from '../../atoms/chip';
import { FieldError } from '../../atoms/field-error';
import { FlexBox } from '../../atoms/flex-box';
import { cn } from '../../tools/cn';
import type { ChipGroupProps } from './types';
/**
@ -16,6 +17,7 @@ export function ChipGroup<T extends string>({
label,
error,
size = 'md',
scroll = false,
disabled = false,
ref,
className,
@ -31,15 +33,19 @@ export function ChipGroup<T extends string>({
tabIndex={-1}
aria-label={label}
aria-describedby={hasError ? errorId : undefined}
wrap="flex-wrap"
wrap={scroll ? 'flex-nowrap' : 'flex-wrap'}
gap="gap-2"
className="rounded-md outline-none"
className={cn(
'min-w-0 rounded-md outline-none',
chipRowVariants({ scroll }),
)}
>
{options.map((option) => (
<Chip
key={option.value}
size={size}
selected={value.includes(option.value)}
className="flex-none"
disabled={disabled}
onClick={() => onToggle(option.value)}
>

View File

@ -15,6 +15,8 @@ export type ChipGroupProps<T extends string> = {
/** Under the chips, such as «انتخاب حداقل یک تخصص الزامی است.». */
error?: ReactNode;
size?: ChipSize;
/** One row that scrolls sideways instead of wrapping. */
scroll?: boolean;
disabled?: boolean;
/** Reaches the fieldset, which takes focus (and scrolls into view) for a form error. */
ref?: Ref<HTMLFieldSetElement>;

View File

@ -0,0 +1,163 @@
'use client';
import { useId, useState } from 'react';
import { Button } from '../../atoms/button';
import { FlexBox } from '../../atoms/flex-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import { textInputBoxVariants, textInputControlVariants } from '../text-input';
import { CODE_INPUT_BOX_STATE } from './constants';
import type { CodeInputProps } from './types';
import { codeInputButtonVariants } from './variants';
/**
* An invite code with its own «ثبت» (DS CodeInput): left to right, the button checks the code and
* so does Enter, which never submits the outer form. Checking locks the field with a spinner;
* a valid code turns green and read-only, and the button becomes «تغییر». The status and every
* text come from the caller.
*/
export function CodeInput({
label,
labels,
status = 'idle',
source = 'typed',
value,
defaultValue = '',
onValueChange,
onCheck,
onEdit,
onBlur,
hint,
message,
placeholder,
frozen = false,
ref,
id: idProp,
name,
className,
}: CodeInputProps) {
const autoId = useId();
const id = idProp ?? autoId;
const messageId = `${id}-message`;
const [ownValue, setOwnValue] = useState(defaultValue);
const code = (value ?? ownValue).trim();
const isValid = status === 'valid';
const isChecking = status === 'checking';
const isLocked = status === 'locked';
const isError = status === 'invalid' || status === 'error';
const isFixed = isValid || isChecking || isLocked;
const shown =
message ??
(isValid && source === 'link'
? (labels.validFromLink ?? labels.valid)
: status === 'idle'
? hint
: labels[status]);
const check = () => {
if (!isFixed && !frozen && code !== '') onCheck(code);
};
return (
<FlexBox
direction="flex-col"
gap="gap-2"
className={cn('min-w-0', className)}
>
<Typography tag="label" variant="label" htmlFor={id}>
{label}
</Typography>
<FlexBox alignItems="items-stretch" gap="gap-2">
<FlexBox
alignItems="items-center"
gap="gap-2"
dir="ltr"
className={cn(
textInputBoxVariants({
state: CODE_INPUT_BOX_STATE[status],
frozen,
}),
'min-w-0 flex-1',
)}
>
<Element
tag="input"
ref={ref}
id={id}
name={name}
type="text"
dir="ltr"
value={value ?? ownValue}
placeholder={placeholder}
readOnly={isFixed}
disabled={frozen}
autoComplete="off"
autoCapitalize="characters"
spellCheck={false}
enterKeyHint="done"
aria-invalid={isError || undefined}
aria-describedby={shown != null ? messageId : undefined}
onChange={(event) => {
if (value === undefined) setOwnValue(event.target.value);
onValueChange?.(event.target.value);
}}
onBlur={() => onBlur?.(code)}
onKeyDown={(event) => {
if (event.key !== 'Enter') return;
event.preventDefault();
check();
}}
className={textInputControlVariants({
ltr: true,
locked: isChecking || isLocked,
})}
/>
{isValid ? (
<Icon name="check-circle" className="text-success-text" />
) : isError ? (
<Icon name="alert" className="text-danger" />
) : isLocked ? (
<Icon name="lock" size={18} className="text-text-secondary" />
) : null}
</FlexBox>
{isValid ? (
<Button
variant="secondary"
frozen={frozen || !onEdit}
onClick={onEdit}
className={codeInputButtonVariants()}
>
{labels.change}
</Button>
) : (
!isLocked && (
<Button
variant="secondary"
isLoading={isChecking}
frozen={frozen || (code === '' && !isChecking)}
onClick={check}
className={codeInputButtonVariants()}
>
{labels.check}
</Button>
)
)}
</FlexBox>
{shown != null && (
<Typography
tag="span"
variant="caption"
id={messageId}
role={isError ? 'alert' : status !== 'idle' ? 'status' : undefined}
color={isError ? 'danger' : isValid ? 'success' : 'secondary'}
>
{shown}
</Typography>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,11 @@
import type { CodeInputStatus } from './types';
/** The box's frame for each status (TextInput's box states). */
export const CODE_INPUT_BOX_STATE = {
idle: 'default',
checking: 'locked',
valid: 'valid',
invalid: 'invalid',
error: 'invalid',
locked: 'locked',
} as const satisfies Record<CodeInputStatus, string>;

View File

@ -0,0 +1,8 @@
export { CodeInput } from './CodeInput';
export type {
CodeInputLabels,
CodeInputProps,
CodeInputSource,
CodeInputStatus,
} from './types';
export { codeInputButtonVariants } from './variants';

View File

@ -0,0 +1,66 @@
import type { ReactNode, Ref } from 'react';
/**
* idle: typed, not checked. checking: «ثبت» was pressed. valid: accepted, read-only until «تغییر».
* invalid: the code doesn't exist. error: the check failed. locked: fixed for this flow.
*/
export type CodeInputStatus =
| 'idle'
| 'checking'
| 'valid'
| 'invalid'
| 'error'
| 'locked';
/** Where the code came from: typed here, or applied from an invite link. */
export type CodeInputSource = 'typed' | 'link';
/** Every text the field shows, from the translations. A state without its text shows none. */
export type CodeInputLabels = {
/** The button that checks the code: «ثبت». */
check: ReactNode;
/** The button on a valid code that unlocks the field: «تغییر». */
change: ReactNode;
/** «در حال بررسی کد…». */
checking?: ReactNode;
/** «کد دعوت معتبر است.». */
valid?: ReactNode;
/** A valid code from an invite link: «کد دعوت از لینک دعوت اعمال شد.». */
validFromLink?: ReactNode;
/** «کد دعوت وارد‌شده معتبر نیست.». */
invalid?: ReactNode;
/** «بررسی کد انجام نشد. دوباره «ثبت» را بزنید.». */
error?: ReactNode;
/** Why a locked code can't change. */
locked?: ReactNode;
};
export type CodeInputProps = {
/** «کد دعوت». */
label: ReactNode;
labels: CodeInputLabels;
status?: CodeInputStatus;
source?: CodeInputSource;
/** Controlled: the code now. Leave it out to let the field keep its own. */
value?: string;
defaultValue?: string;
onValueChange?: (value: string) => void;
/** «ثبت» or Enter, with the trimmed code; never while checking, valid, locked or empty. */
onCheck: (code: string) => void;
/** «تغییر» on a valid code: the caller sets the status back to idle. */
onEdit?: () => void;
/** Leaving the field, with the trimmed code, such as for a quiet check. */
onBlur?: (code: string) => void;
/** Under the field while idle. */
hint?: ReactNode;
/** Replaces the status's text. */
message?: ReactNode;
placeholder?: string;
/** Visible but unusable now, at 40%. */
frozen?: boolean;
/** Reaches the input, such as react-hook-form's field ref. */
ref?: Ref<HTMLInputElement>;
id?: string;
name?: string;
className?: string;
};

View File

@ -0,0 +1,4 @@
import { cva } from 'class-variance-authority';
/** «ثبت» and «تغییر» as tall as the field beside them (48px). */
export const codeInputButtonVariants = cva('min-h-input-height flex-none');

View File

@ -1,29 +1,66 @@
import { Button } from '../../atoms/button';
import { FlexBox } from '../../atoms/flex-box';
import { Typography } from '../../atoms/typography';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { DetailRowProps } from './types';
import { detailRowVariants } from './variants';
import { detailRowVariants, detailValueVariants } from './variants';
/**
* One line of a `<dl>`, such as a receipt or a payment's detail: the label at the start, its
* value at the end, on one baseline.
* One line of a `<dl>` (DS KV), such as a receipt or a payment's detail: the key at the start in
* 13px secondary, its value at the end on one baseline. Put rows in a KeyValue for the DS group with
* hairlines, or in any `dl`.
*/
export function DetailRow({ label, children, size }: DetailRowProps) {
export function DetailRow({
label,
children,
size,
strong = false,
tone,
ltr = false,
copyLabel,
onCopy,
className,
}: DetailRowProps) {
return (
<FlexBox
alignItems="items-baseline"
justifyContent="justify-between"
gap="gap-3"
className={detailRowVariants({ size })}
className={cn(detailRowVariants({ size }), className)}
>
<Element tag="dt">
<Typography tag="span" variant="body-sm" color="secondary">
{label}
</Typography>
</Element>
<Element tag="dd" className="m-0 text-end font-semibold">
{children}
</Element>
<Typography
tag="dt"
variant="caption"
color="secondary"
className="max-w-1/2 flex-none"
>
{label}
</Typography>
<FlexBox
tag="dd"
alignItems="items-center"
justifyContent="justify-end"
wrap="flex-wrap"
className={cn(detailValueVariants({ strong, tone }), 'gap-1.5')}
>
{ltr ? (
<Element tag="bdi" dir="ltr">
{children}
</Element>
) : (
children
)}
{copyLabel && onCopy && (
<Button
variant="ghost"
size="sm"
icon="copy"
label={copyLabel}
onClick={onCopy}
/>
)}
</FlexBox>
</FlexBox>
);
}

View File

@ -1,3 +1,3 @@
export { DetailRow } from './DetailRow';
export type { DetailRowProps } from './types';
export { detailRowVariants } from './variants';
export type { DetailRowProps, DetailRowTone } from './types';
export { detailRowVariants, detailValueVariants } from './variants';

View File

@ -1,10 +1,29 @@
import type { VariantProps } from 'class-variance-authority';
import type { ReactNode } from 'react';
import type { detailRowVariants } from './variants';
import type { detailRowVariants, detailValueVariants } from './variants';
export type DetailRowTone = NonNullable<
VariantProps<typeof detailValueVariants>['tone']
>;
export type DetailRowProps = VariantProps<typeof detailRowVariants> & {
/** The key: 13/22 secondary, at most half the row. */
label: ReactNode;
/** The value, at the end. */
children: ReactNode;
/**
* The value, at the end: text, an `Amount` or a `StatusBadge` (put the badge before the text
* when both show).
*/
children?: ReactNode;
/** 600 instead of regular, such as a total or the period bought. */
strong?: boolean;
/** A status hue for the value, always 600, such as «بازگشت داده شد» in success. */
tone?: DetailRowTone;
/** Left to right in its own isolate: a reference, a شبا, a username. */
ltr?: boolean;
/** Shows a ghost copy button after the value; its accessible name, such as «کپی کد پیگیری». */
copyLabel?: string;
/** Called by the copy button; copy and toast in the caller. */
onCopy?: () => void;
className?: string;
};

View File

@ -1,7 +1,10 @@
import { cva } from 'class-variance-authority';
/** `sm` for a receipt card, `md` for a detail sheet's divided list. */
export const detailRowVariants = cva('', {
/**
* One key–value line (DS KV). `sm` for a receipt card, `md` (8px, the DS) for a detail sheet or a
* KeyValue group.
*/
export const detailRowVariants = cva('min-w-0', {
variants: {
size: {
sm: 'py-1.5',
@ -10,3 +13,23 @@ export const detailRowVariants = cva('', {
},
defaultVariants: { size: 'md' },
});
/**
* The value at the end, 15/26: regular unless `strong`; a status tone is always 600. Its parts
* (badge, value, copy) sit in one end-aligned row that wraps.
*/
export const detailValueVariants = cva(
'm-0 min-w-0 text-end text-[0.9375rem] leading-[1.625rem]',
{
variants: {
strong: { true: 'font-semibold', false: 'font-normal' },
tone: {
default: 'text-text-primary',
success: 'font-semibold text-success-text',
danger: 'font-semibold text-danger-text',
warning: 'font-semibold text-warning-text',
},
},
defaultVariants: { strong: false, tone: 'default' },
},
);

View File

@ -13,9 +13,10 @@ import type { FileFieldProps } from './types';
import { fileDropVariants, filePickedVariants } from './variants';
/**
* One file to send with a form, such as a national ID card image. Empty, the whole dashed box
* opens the picker; picked, it shows a thumbnail (for images), the name and the size with a
* remove button; uploading, a bar with the percent replaces remove. The file stays in memory.
* One file to send with a form, such as a national ID card image (DS UploadTile). Empty, the whole
* dashed box opens the picker; picked, an image shows whole above its name and size, with
* «تغییر تصویر» (`labels.change`) and remove; uploading, a bar with the percent replaces them. The
* file stays in memory.
*/
export function FileField({
label,
@ -39,6 +40,15 @@ export function FileField({
const messageId = `${id}-message`;
const isInvalid = error != null && error !== false;
const isUploading = progress !== undefined;
const isImage = file?.type.startsWith('image/') ?? false;
const inputRef = useRef<HTMLInputElement | null>(null);
// The input stays mounted, so «تغییر تصویر» can open it; the form's ref reaches it too.
const attachInput = (node: HTMLInputElement | null) => {
inputRef.current = node;
if (typeof ref === 'function') ref(node);
else if (ref) ref.current = node;
};
const pick = (event: ChangeEvent<HTMLInputElement>) => {
onChange(event.target.files?.[0] ?? null);
@ -55,62 +65,97 @@ export function FileField({
<Typography tag="span" variant="label" id={`${id}-label`}>
{label}
</Typography>
<Element
tag="input"
ref={attachInput}
type="file"
id={id}
name={name}
accept={accept}
disabled={disabled}
// Picked, the change button opens it; it leaves the tab order.
tabIndex={file ? -1 : undefined}
onChange={pick}
onBlur={onBlur}
aria-labelledby={`${id}-label`}
aria-invalid={isInvalid || undefined}
aria-describedby={isInvalid || hint != null ? messageId : undefined}
className="peer sr-only"
/>
{file ? (
<FlexBox
alignItems="items-center"
gap="gap-3"
direction="flex-col"
gap="gap-2"
className={filePickedVariants({ invalid: isInvalid })}
>
{file.type.startsWith('image/') ? (
<Thumbnail file={file} />
) : (
<Icon
name="upload"
size={24}
className="flex-none text-text-secondary"
/>
)}
<FlexBox direction="flex-col" gap="gap-1" className="min-w-0 flex-1">
<Typography
tag="span"
variant="body-sm"
dir="ltr"
className="truncate text-start font-semibold"
{isImage && <Preview file={file} />}
<FlexBox alignItems="items-center" gap="gap-3" className="ps-2">
{!isImage && (
<Icon
name="file"
size={24}
className="flex-none text-text-secondary"
/>
)}
<FlexBox
direction="flex-col"
gap="gap-1"
className="min-w-0 flex-1"
>
{file.name}
</Typography>
{isUploading ? (
<>
<Element
tag="progress"
value={progress}
max={100}
aria-labelledby={`${id}-label`}
className="h-1 w-full appearance-none overflow-hidden rounded-full bg-surface-sunken [&::-moz-progress-bar]:bg-action-primary [&::-webkit-progress-bar]:bg-surface-sunken [&::-webkit-progress-value]:bg-action-primary"
/>
{labels.uploading && (
<Typography
tag="span"
variant="body-sm"
dir="ltr"
className="truncate text-start font-semibold"
>
{file.name}
</Typography>
{isUploading ? (
<>
<Element
tag="progress"
value={progress}
max={100}
aria-labelledby={`${id}-label`}
className="h-2 w-full appearance-none overflow-hidden rounded-full bg-surface-sunken [&::-moz-progress-bar]:bg-action-primary [&::-webkit-progress-bar]:bg-surface-sunken [&::-webkit-progress-value]:bg-action-primary"
/>
{labels.uploading && (
<Typography tag="span" variant="caption" color="secondary">
{labels.uploading(progress)}
</Typography>
)}
</>
) : (
size != null && (
<Typography tag="span" variant="caption" color="secondary">
{labels.uploading(progress)}
{size}
</Typography>
)}
</>
) : (
size != null && (
<Typography tag="span" variant="caption" color="secondary">
{size}
</Typography>
)
)
)}
</FlexBox>
{!isUploading && labels.change != null && (
<Button
variant="secondary"
size="sm"
icon="refresh"
disabled={disabled}
onClick={() => inputRef.current?.click()}
className="flex-none"
>
{labels.change}
</Button>
)}
{!isUploading && (
<Button
variant="ghost"
icon="trash"
label={labels.remove}
disabled={disabled}
onClick={() => onChange(null)}
className="flex-none"
/>
)}
</FlexBox>
{!isUploading && (
<Button
variant="ghost"
icon="trash"
label={labels.remove}
disabled={disabled}
onClick={() => onChange(null)}
/>
)}
</FlexBox>
) : (
<FlexBox
@ -119,31 +164,22 @@ export function FileField({
direction="flex-col"
alignItems="items-center"
justifyContent="justify-center"
gap="gap-1"
className={fileDropVariants({ invalid: isInvalid, disabled })}
className={cn(
fileDropVariants({ invalid: isInvalid, disabled }),
'gap-1.5',
)}
>
<Icon name="upload" size={24} className="text-text-secondary" />
<Typography tag="span" variant="label" color="link">
<Icon name="upload" size={28} className="text-text-secondary" />
<Typography
tag="span"
variant="inherit"
className="text-[0.9375rem] leading-6 font-semibold"
>
{labels.pick}
</Typography>
<Typography tag="span" variant="caption" color="secondary">
{labels.rules}
</Typography>
<Element
tag="input"
ref={ref}
type="file"
id={id}
name={name}
accept={accept}
disabled={disabled}
onChange={pick}
onBlur={onBlur}
aria-labelledby={`${id}-label`}
aria-invalid={isInvalid || undefined}
aria-describedby={isInvalid || hint != null ? messageId : undefined}
className="sr-only"
/>
</FlexBox>
)}
{isInvalid && error !== true ? (
@ -175,8 +211,11 @@ export function FileField({
);
}
/** An image file's thumbnail from an object URL, revoked when the file changes or leaves. */
function Thumbnail({ file }: { file: File }) {
/**
* An image file shown whole, at most 220px tall, from an object URL revoked when the file changes
* or leaves.
*/
function Preview({ file }: { file: File }) {
const ref = useRef<HTMLImageElement>(null);
useEffect(() => {
const url = URL.createObjectURL(file);
@ -188,7 +227,7 @@ function Thumbnail({ file }: { file: File }) {
tag="img"
ref={ref}
alt=""
className="size-12 flex-none rounded-sm bg-surface-sunken object-cover"
className="max-h-55 w-full rounded-md bg-surface-sunken object-cover"
/>
);
}

View File

@ -8,6 +8,8 @@ export type FileFieldLabels = {
rules: ReactNode;
/** The remove button's accessible name: «حذف تصویر». */
remove: string;
/** Shows a button on the picked file that picks another: «تغییر تصویر». */
change?: ReactNode;
/** While uploading, given the percent: «در حال بارگذاری… ۶۴٪». */
uploading?: (percent: number) => ReactNode;
};

View File

@ -1,8 +1,11 @@
import { cva } from 'class-variance-authority';
/** The empty box: the whole box is the picker's label, so it is one large target. */
/**
* The empty box (DS UploadTile): 140px, a 1.5px dashed outline on surface. The whole box is the
* picker's label, so it is one large target; it shows the hidden input's keyboard focus.
*/
export const fileDropVariants = cva(
'min-h-30 rounded-md border border-dashed bg-surface-sunken px-4 py-5 text-center transition-colors duration-120 ease-standard has-focus-visible:focus-ring',
'min-h-35 rounded-lg border-[1.5px] border-dashed bg-surface p-4 text-center transition-colors duration-120 ease-standard peer-focus-visible:focus-ring',
{
variants: {
invalid: {
@ -16,12 +19,15 @@ export const fileDropVariants = cva(
},
);
/** The picked file's row: thumbnail, name and size, then remove or the upload bar. */
/**
* The picked file (DS UploadTile `done`): a solid hairline frame with an image's whole preview,
* then its name and size with «تغییر تصویر» and remove, or the upload bar.
*/
export const filePickedVariants = cva(
'min-h-18 rounded-md border bg-surface p-3',
'min-h-18 rounded-lg border bg-surface p-2',
{
variants: {
invalid: { true: 'border-danger', false: 'border-border-default' },
invalid: { true: 'border-danger', false: 'border-border-subtle' },
},
defaultVariants: { invalid: false },
},

View File

@ -1,6 +1,6 @@
import { useId } from 'react';
import { chipVariants } from '../../atoms/chip';
import { chipRowVariants, chipVariants } from '../../atoms/chip';
import { FlexBox } from '../../atoms/flex-box';
import { Typography } from '../../atoms/typography';
import { Element } from '../../primitives/element';
@ -19,6 +19,7 @@ export function FilterChips<T extends string>({
onChange,
label,
size = 'md',
scroll = false,
disabled = false,
className,
}: FilterChipsProps<T>) {
@ -30,9 +31,13 @@ export function FilterChips<T extends string>({
role="radiogroup"
aria-label={label}
disabled={disabled}
wrap="flex-wrap"
wrap={scroll ? 'flex-nowrap' : 'flex-wrap'}
gap="gap-2"
className={cn('m-0 min-w-0 border-0 p-0', className)}
className={cn(
'm-0 min-w-0 border-0 p-0',
chipRowVariants({ scroll }),
className,
)}
>
{options.map((option) => (
<FlexBox
@ -42,7 +47,7 @@ export function FilterChips<T extends string>({
alignItems="items-center"
className={cn(
chipVariants({ selected: option.value === value, size }),
'relative has-[input:focus-visible]:focus-ring',
'relative flex-none has-[input:focus-visible]:focus-ring',
)}
>
<Element
@ -54,7 +59,7 @@ export function FilterChips<T extends string>({
onChange={() => onChange(option.value)}
className="pointer-events-none absolute m-0 size-px opacity-0"
/>
<Typography tag="span" variant="label" color="inherit">
<Typography tag="span" variant="inherit" color="inherit">
{option.label}
</Typography>
</FlexBox>

View File

@ -15,6 +15,8 @@ export type FilterChipsProps<T extends string> = {
label: string;
/** `md` (44px) on a page, `sm` (36px) in a compact row. */
size?: ChipSize;
/** One row that scrolls sideways instead of wrapping, such as a filter under a top bar. */
scroll?: boolean;
disabled?: boolean;
className?: string;
};

View File

@ -0,0 +1,29 @@
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { KeyValueProps } from './types';
import { keyValueVariants } from './variants';
/**
* A `dl` of DetailRows (DS KeyValue), such as a payment's receipt or a payout's detail: on its own,
* in a sunken block, or in a card, with hairlines between rows.
*/
export function KeyValue({
tone = 'plain',
lines = true,
className,
children,
...props
}: KeyValueProps) {
return (
<Element
tag="dl"
className={cn(
keyValueVariants({ tone, lines: lines && tone !== 'soft' }),
className,
)}
{...props}
>
{children}
</Element>
);
}

View File

@ -0,0 +1,3 @@
export { KeyValue } from './KeyValue';
export type { KeyValueProps, KeyValueTone } from './types';
export { keyValueVariants } from './variants';

View File

@ -0,0 +1,17 @@
import type { VariantProps } from 'class-variance-authority';
import type { ComponentPropsWithRef, ReactNode } from 'react';
import type { keyValueVariants } from './variants';
export type KeyValueTone = NonNullable<
VariantProps<typeof keyValueVariants>['tone']
>;
export type KeyValueProps = Omit<ComponentPropsWithRef<'dl'>, 'children'> & {
/** `plain` (default), `soft` sunken (never with hairlines) or `card`. */
tone?: KeyValueTone;
/** Hairlines between rows; on by default, always off in `soft`. */
lines?: boolean;
/** DetailRows. */
children: ReactNode;
};

View File

@ -0,0 +1,20 @@
import { cva } from 'class-variance-authority';
/**
* The DS KeyValue group of DetailRows: `plain` on its own, `soft` a sunken block (no hairlines),
* `card` a bordered radius-lg surface. `lines` draws a hairline between rows.
*/
export const keyValueVariants = cva('m-0 min-w-0', {
variants: {
tone: {
plain: '',
soft: 'rounded-md bg-surface-sunken px-4 py-1',
card: 'rounded-lg border border-border-subtle bg-surface px-4 py-1',
},
lines: {
true: '[&>*+*]:border-t [&>*+*]:border-border-subtle',
false: '',
},
},
defaultVariants: { tone: 'plain', lines: true },
});

View File

@ -0,0 +1,46 @@
import { FlexBox } from '../../atoms/flex-box';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { ListProps } from './types';
import {
listHeaderVariants,
listItemsVariants,
listVariants,
} from './variants';
/**
* The grouped list that ListRows sit in: notifications, transactions, ledger lines, following, a
* plan's subscribers. A real `ul`, with a hairline between rows and an optional header strip
* inside the group. Name it with `aria-label` when no heading precedes it.
*/
export function List({
tone,
header,
children,
className,
...props
}: ListProps) {
if (header == null) {
return (
<Element
tag="ul"
className={cn(listVariants({ tone }), listItemsVariants(), className)}
{...props}
>
{children}
</Element>
);
}
return (
<FlexBox
direction="flex-col"
className={cn(listVariants({ tone }), className)}
>
<Element className={listHeaderVariants()}>{header}</Element>
<Element tag="ul" className={listItemsVariants()} {...props}>
{children}
</Element>
</FlexBox>
);
}

View File

@ -0,0 +1,174 @@
import NextLink from 'next/link';
import { FlexBox } from '../../atoms/flex-box';
import { GridBox } from '../../atoms/grid-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { ListRowProps } from './types';
import { listRowIconVariants, listRowVariants } from './variants';
/**
* One row of a List (DS ListRow): a lead (avatar or a 40px icon tile), the title with an optional
* subtitle and meta, an end column (an Amount, a StatusBadge, a caption) and a chevron for a link.
* With `href` the whole row is a link, with `onClick` a button (such as one that opens a detail
* sheet), otherwise a plain row. Renders its own `li`, so it always sits in a List. Every text
* comes from the caller.
*/
export function ListRow(props: ListRowProps) {
const {
title,
subtitle,
meta,
children,
leading,
icon,
iconTone,
end,
chevron,
unread = false,
unreadLabel,
dimmed = false,
disabled = false,
className,
} = props;
const hasSecondLine = subtitle != null || meta != null || children != null;
const showChevron = chevron ?? props.href !== undefined;
const classes = cn(
listRowVariants({
unread,
dimmed,
disabled,
interactive: props.href !== undefined || props.onClick !== undefined,
}),
className,
);
const layout = {
alignItems: hasSecondLine ? 'items-start' : 'items-center',
gap: 'gap-3',
} as const;
const content = (
<>
{unread && (
<Element
tag="span"
role={unreadLabel ? 'img' : undefined}
aria-label={unreadLabel}
aria-hidden={unreadLabel ? undefined : true}
className="absolute start-1.5 top-4.5 size-1.5 rounded-full bg-action-primary"
/>
)}
{leading ??
(icon && (
<GridBox
tag="span"
aria-hidden
justifyItems="justify-items-center"
alignItems="items-center"
className={listRowIconVariants({ tone: iconTone })}
>
<Icon name={icon} size={20} />
</GridBox>
))}
<FlexBox
tag="span"
direction="flex-col"
className="min-w-0 flex-1 gap-0.5"
>
<Typography
tag="span"
variant="inherit"
color="inherit"
className="text-[0.9375rem] leading-6 font-semibold"
>
{title}
</Typography>
{subtitle != null && (
<Typography
tag="span"
variant="body-sm"
color="secondary"
className="leading-[1.375rem]"
>
{subtitle}
</Typography>
)}
{children}
{meta != null && (
<Typography
tag="span"
variant="inherit"
color="tertiary"
className="text-[0.75rem] leading-5"
>
{meta}
</Typography>
)}
</FlexBox>
{end != null && (
<FlexBox
tag="span"
direction="flex-col"
alignItems="items-end"
gap="gap-1"
className="flex-none"
>
{end}
</FlexBox>
)}
{showChevron && (
<Icon
name="chevron-left"
size={20}
className="self-center text-text-tertiary"
/>
)}
</>
);
let row;
if (props.href !== undefined && !disabled) {
row = (
<FlexBox
tag={NextLink}
href={props.href}
onClick={props.onClick}
{...layout}
className={classes}
>
{content}
</FlexBox>
);
} else if (props.href === undefined && props.onClick !== undefined) {
row = (
<FlexBox
tag="button"
type="button"
onClick={props.onClick}
disabled={disabled}
{...layout}
className={classes}
>
{content}
</FlexBox>
);
} else {
row = (
<FlexBox
aria-disabled={disabled || undefined}
{...layout}
className={classes}
>
{content}
</FlexBox>
);
}
return (
<Element tag="li" className="min-w-0">
{row}
</Element>
);
}

View File

@ -0,0 +1,17 @@
export { List } from './List';
export { ListRow } from './ListRow';
export type {
ListProps,
ListRowAsButtonProps,
ListRowAsLinkProps,
ListRowIconTone,
ListRowProps,
ListTone,
} from './types';
export {
listHeaderVariants,
listItemsVariants,
listRowIconVariants,
listRowVariants,
listVariants,
} from './variants';

View File

@ -0,0 +1,66 @@
import type { VariantProps } from 'class-variance-authority';
import type { ComponentPropsWithRef, MouseEvent, ReactNode } from 'react';
import type { IconName } from '../../atoms/icon';
import type { listRowIconVariants, listVariants } from './variants';
export type ListTone = NonNullable<VariantProps<typeof listVariants>['tone']>;
export type ListRowIconTone = NonNullable<
VariantProps<typeof listRowIconVariants>['tone']
>;
export type ListProps = Omit<ComponentPropsWithRef<'ul'>, 'children'> & {
/** `card` (default) on a page, `soft` inside a card or a sheet, `flush` edge to edge. */
tone?: ListTone;
/**
* A strip above the rows inside the group, such as a SectionTitle or a filter. For a heading
* outside the group, put a SectionTitle before the List instead.
*/
header?: ReactNode;
/** ListRows. */
children: ReactNode;
};
type ListRowBaseProps = {
/** 15/600 primary, such as a channel's name or «پرداخت اشتراک». */
title: ReactNode;
/** 14 secondary under the title, such as the plan or the notification's text. */
subtitle?: ReactNode;
/** 12 tertiary, last, such as a date. */
meta?: ReactNode;
/** Anything else under the subtitle, before `meta`. */
children?: ReactNode;
/** The lead slot, such as an `Avatar`; wins over `icon`. */
leading?: ReactNode;
/** A 40px icon tile as the lead, in `iconTone`. */
icon?: IconName;
iconTone?: ListRowIconTone;
/** The end column, stacked and end-aligned: an `Amount`, a `StatusBadge`, a caption. */
end?: ReactNode;
/** The `chevron-left` at the end. On by itself for a link row; pass false to hide it. */
chevron?: boolean;
/** Tinted with a dot at the inline start. */
unread?: boolean;
/** The dot's accessible name, such as «خوانده‌نشده». */
unreadLabel?: string;
/** An unavailable item: every child but those marked `data-keep` drops to 50%. */
dimmed?: boolean;
/** Can't be opened now: 40%, no pointer, `aria-disabled`; a link row renders no link. */
disabled?: boolean;
className?: string;
};
/** A link row: the whole row goes to `href`. */
export type ListRowAsLinkProps = ListRowBaseProps & {
href: string;
onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
};
/** A button row, such as one that opens a detail sheet; a plain row when `onClick` is absent too. */
export type ListRowAsButtonProps = ListRowBaseProps & {
href?: undefined;
onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
};
export type ListRowProps = ListRowAsLinkProps | ListRowAsButtonProps;

View File

@ -0,0 +1,79 @@
import { cva } from 'class-variance-authority';
/**
* The group the rows sit in, with a hairline between rows. `card` is a bordered radius-lg surface;
* `soft` a sunken radius-md block inside a card or a sheet; `flush` reaches the screen's edges, with
* no radius or side borders.
*/
export const listVariants = cva('min-w-0 overflow-hidden', {
variants: {
tone: {
card: 'rounded-lg border border-border-subtle bg-surface',
soft: 'rounded-md bg-surface-sunken',
flush: 'border-y border-border-subtle bg-surface',
},
},
defaultVariants: { tone: 'card' },
});
/** The `ul` itself: no bullets or indent, a hairline between rows. */
export const listItemsVariants = cva(
'm-0 list-none p-0 [&>li+li]:border-t [&>li+li]:border-border-subtle',
);
/** The optional header strip above the rows, over its own hairline. */
export const listHeaderVariants = cva(
'min-h-12 border-b border-border-subtle px-4 py-2',
);
/**
* One 64px row: lead, text, end column, chevron. Top-aligned when it has a second line, centred
* when only a title. An unread row is tinted with a dot at its start; a dimmed one fades every child
* but those marked `data-keep`. As a link or a button the whole row is the hit area, and its focus
* ring sits inside, so the list's rounded clip never cuts it.
*/
export const listRowVariants = cva(
'relative min-h-16 w-full px-4 py-3 text-start text-text-primary no-underline transition-colors duration-120 ease-standard',
{
variants: {
unread: { true: 'bg-action-primary-subtle', false: 'bg-transparent' },
interactive: {
true: 'focus-visible:outline-2 focus-visible:-outline-offset-2 focus-visible:outline-action-primary actionable:cursor-pointer actionable:hover:bg-surface-hover',
false: '',
},
dimmed: {
true: '[&>:not([data-keep])]:opacity-(--opacity-dimmed)',
false: '',
},
disabled: { true: 'frozen', false: '' },
},
compoundVariants: [
{
unread: true,
interactive: true,
className: 'actionable:hover:bg-action-primary-muted',
},
],
defaultVariants: {
unread: false,
interactive: false,
dimmed: false,
disabled: false,
},
},
);
/** The 40px lead tile, radius 12, in a tone's subtle ground. */
export const listRowIconVariants = cva('size-10 flex-none rounded-lg', {
variants: {
tone: {
neutral: 'bg-surface-sunken text-text-secondary',
brand: 'bg-action-primary-subtle text-action-primary-text',
success: 'bg-success-subtle text-success-text',
danger: 'bg-danger-subtle text-danger-text',
warning: 'bg-warning-subtle text-warning-text',
premium: 'bg-premium text-premium-on',
},
},
defaultVariants: { tone: 'neutral' },
});

View File

@ -0,0 +1,68 @@
import { useId } from 'react';
import { FlexBox } from '../../atoms/flex-box';
import { Typography } from '../../atoms/typography';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { MeterProps } from './types';
import { meterBarVariants } from './variants';
/**
* A progress bar with its label and value (DS Meter), such as an invite code's capacity or an
* upload: the label and caption on one row, the 8px bar, then a hint.
*/
export function Meter({
value,
max = 100,
label,
caption,
hint,
tone,
ariaLabel,
valueText,
className,
}: MeterProps) {
const labelId = useId();
return (
<FlexBox direction="flex-col" className={cn('min-w-0 gap-1.5', className)}>
{(label != null || caption != null) && (
<FlexBox
alignItems="items-baseline"
justifyContent="justify-between"
gap="gap-2"
>
{label != null && (
<Typography tag="span" variant="label" id={labelId}>
{label}
</Typography>
)}
{caption != null && (
<Typography
tag="span"
variant="caption"
color="secondary"
className="ms-auto"
>
{caption}
</Typography>
)}
</FlexBox>
)}
<Element
tag="progress"
value={Math.max(0, Math.min(value, max))}
max={max}
aria-valuetext={valueText}
aria-labelledby={label != null ? labelId : undefined}
aria-label={label != null ? undefined : ariaLabel}
className={meterBarVariants({ tone })}
/>
{hint != null && (
<Typography tag="span" variant="caption" color="secondary">
{hint}
</Typography>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { Meter } from './Meter';
export type { MeterProps, MeterTone } from './types';
export { meterBarVariants } from './variants';

View File

@ -0,0 +1,26 @@
import type { VariantProps } from 'class-variance-authority';
import type { ReactNode } from 'react';
import type { meterBarVariants } from './variants';
export type MeterTone = NonNullable<
VariantProps<typeof meterBarVariants>['tone']
>;
export type MeterProps = {
value: number;
/** 100 by default. */
max?: number;
/** 14/600 above the bar at the start, and the bar's accessible name. */
label?: ReactNode;
/** The value in words at the end of the label row, such as «۱۲ از ۲۰ ظرفیت». */
caption?: ReactNode;
/** A caption under the bar. */
hint?: ReactNode;
tone?: MeterTone;
/** The accessible name when there is no visible `label`. */
ariaLabel?: string;
/** What a screen reader says for the value, such as «۱۲ از ۲۰». */
valueText?: string;
className?: string;
};

View File

@ -0,0 +1,26 @@
import { cva } from 'class-variance-authority';
/**
* The native `progress`, drawn as the DS Meter: an 8px sunken track whose filled part takes the
* tone's hue, brand by default.
*/
export const meterBarVariants = cva(
'block h-2 w-full appearance-none overflow-hidden rounded-full border-0 bg-surface-sunken [&::-moz-progress-bar]:rounded-full [&::-webkit-progress-bar]:bg-surface-sunken [&::-webkit-progress-value]:rounded-full',
{
variants: {
tone: {
brand:
'[&::-moz-progress-bar]:bg-action-primary [&::-webkit-progress-value]:bg-action-primary',
success:
'[&::-moz-progress-bar]:bg-success [&::-webkit-progress-value]:bg-success',
warning:
'[&::-moz-progress-bar]:bg-warning [&::-webkit-progress-value]:bg-warning',
danger:
'[&::-moz-progress-bar]:bg-danger [&::-webkit-progress-value]:bg-danger',
neutral:
'[&::-moz-progress-bar]:bg-text-tertiary [&::-webkit-progress-value]:bg-text-tertiary',
},
},
defaultVariants: { tone: 'brand' },
},
);

View File

@ -15,7 +15,8 @@ import { modalPanelVariants } from './variants';
* focus returns to the trigger when it closes.
*
* `size="wide"` is the desktop form dialog (C4 ۷.۳, «پست جدید»): 640px, a header row with the
* title and `headerAction`, then the caller's body and footer bar, edge to edge.
* title and `headerAction`, then the caller's body and footer bar, edge to edge. `size="xwide"`
* is the same at 960px.
*/
export function Modal({
open,
@ -44,7 +45,7 @@ export function Modal({
labelledBy={titleId}
className="items-center justify-center p-4"
>
{size === 'wide' ? (
{size === 'wide' || size === 'xwide' ? (
<FlexBox
data-dialog-panel=""
tabIndex={-1}

View File

@ -1,13 +1,17 @@
import type { ReactNode } from 'react';
/** default: a short decision at 420px. wide: a desktop form at the 640px column (C4 ۷.۳). */
export type ModalSize = 'default' | 'wide';
/**
* default: a short decision at 420px. wide: a desktop form at the 640px column (C4 ۷.۳). xwide:
* the 960px workspace, such as the desktop prediction composer (DS Dialog `width="wide"`); laid
* out as wide.
*/
export type ModalSize = 'default' | 'wide' | 'xwide';
export type ModalProps = {
open: boolean;
title: ReactNode;
/**
* The body. default: in body-md under the title. wide: edge to edge with no padding; lay out
* The body. default: in body-md under the title. wide and xwide: edge to edge with no padding; lay out
* the scrolling body and the footer bar yourself (a `min-h-0` flex column, so the body scrolls).
*/
children?: ReactNode;

View File

@ -9,6 +9,8 @@ export const modalPanelVariants = cva(
default: 'max-w-105 overflow-auto px-5 pt-6 pb-5',
/** C4 ۷.۳: no padding, so the header row and the caller's footer bar reach the edges. */
wide: 'max-w-content overflow-hidden',
/** The DS 960px dialog with no padding, such as the desktop prediction composer (J09). */
xwide: 'max-w-240 overflow-hidden',
},
},
defaultVariants: { size: 'default' },

View File

@ -0,0 +1,62 @@
import { Button } from '../../atoms/button';
import { FlexBox } from '../../atoms/flex-box';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import type { PageHeaderProps } from './types';
import { pageHeaderTitleVariants } from './variants';
/**
* A page's title row (DS PageHeader): an optional back button, the h1 with an optional subtitle,
* and actions at the end. Desktop pages and in-page titles; the mobile top bar has its own title.
*/
export function PageHeader({
title,
subtitle,
actions,
size,
backHref,
backLabel,
titleId,
titleRef,
className,
}: PageHeaderProps) {
return (
<FlexBox
alignItems="items-center"
gap="gap-3"
className={cn('min-w-0', className)}
>
{backHref && backLabel && (
<Button
href={backHref}
variant="ghost"
icon="chevron-right"
label={backLabel}
className="-ms-2 text-text-primary"
/>
)}
<FlexBox direction="flex-col" className="min-w-0 flex-1 gap-0.5">
<Typography
tag="h1"
id={titleId}
ref={titleRef}
tabIndex={titleRef ? -1 : undefined}
variant="inherit"
className={cn(pageHeaderTitleVariants({ size }), 'outline-none')}
>
{title}
</Typography>
{subtitle != null && (
<Typography variant="body-sm" color="secondary" className="m-0">
{subtitle}
</Typography>
)}
</FlexBox>
{actions != null && (
<FlexBox alignItems="items-center" gap="gap-2" className="flex-none">
{actions}
</FlexBox>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { PageHeader } from './PageHeader';
export type { PageHeaderProps, PageHeaderSize } from './types';
export { pageHeaderTitleVariants } from './variants';

View File

@ -0,0 +1,28 @@
import type { VariantProps } from 'class-variance-authority';
import type { ReactNode, Ref } from 'react';
import type { pageHeaderTitleVariants } from './variants';
export type PageHeaderSize = NonNullable<
VariantProps<typeof pageHeaderTitleVariants>['size']
>;
export type PageHeaderProps = {
/** The page's h1. */
title: ReactNode;
/** 14/24 secondary under the title. */
subtitle?: ReactNode;
/** Buttons at the end, such as «پست جدید». */
actions?: ReactNode;
/** `md` (default, 22px) or `sm` (18px). */
size?: PageHeaderSize;
/** A back icon button before the title goes here; needs `backLabel`. */
backHref?: string;
/** The back button's accessible name, such as «بازگشت». */
backLabel?: string;
/** The h1's id, so a section can be labelled by it. */
titleId?: string;
/** A page that moves focus to its title gets `tabIndex={-1}` on it. */
titleRef?: Ref<HTMLHeadingElement>;
className?: string;
};

View File

@ -0,0 +1,15 @@
import { cva } from 'class-variance-authority';
/**
* The page's h1: `md` 22/36/700 (DS default: desktop pages, in-page titles), `sm` 18/30/600 (a
* compact title, such as on mobile under a tab bar).
*/
export const pageHeaderTitleVariants = cva('m-0 min-w-0', {
variants: {
size: {
md: 'text-[1.375rem] leading-9 font-bold',
sm: 'text-[1.125rem] leading-7.5 font-semibold',
},
},
defaultVariants: { size: 'md' },
});

View File

@ -0,0 +1,59 @@
import { FlexBox } from '../../atoms/flex-box';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import type { PinnedFooterProps } from './types';
import { pinnedFooterVariants } from './variants';
/**
* The bottom bar of a task flow on mobile (DS PinnedFooter), such as checkout's «پرداخت»: an
* optional total row, an optional centred note, then the actions. Sticky at the bottom of its
* scrolling column, clear of the home indicator. A toast over it sits at
* `PINNED_FOOTER_TOAST_OFFSET`; the footer carries `data-pinned-footer` for that.
*/
export function PinnedFooter({
children,
total,
totalLabel,
note,
layout = 'stack',
className,
...props
}: PinnedFooterProps) {
return (
<FlexBox
tag="footer"
data-pinned-footer=""
direction={layout === 'row' ? 'flex-row' : 'flex-col'}
alignItems={layout === 'row' ? 'items-center' : undefined}
gap="gap-2"
className={cn(pinnedFooterVariants(), className)}
{...props}
>
{total != null && (
<FlexBox
alignItems="items-baseline"
justifyContent="justify-between"
gap="gap-3"
className={layout === 'row' ? 'min-w-0 flex-1' : undefined}
>
{totalLabel != null && (
<Typography tag="span" color="secondary">
{totalLabel}
</Typography>
)}
{total}
</FlexBox>
)}
{note != null && (
<Typography
variant="caption"
color="secondary"
className="m-0 text-center"
>
{note}
</Typography>
)}
{children}
</FlexBox>
);
}

View File

@ -0,0 +1,6 @@
/**
* px from the screen's bottom edge to a toast shown over a pinned footer (DS ShellToast `footer`),
* so the toast never covers the footer's actions. The footer marks itself with
* `data-pinned-footer`, so the toast layer can find it with `:has()`.
*/
export const PINNED_FOOTER_TOAST_OFFSET = 152;

View File

@ -0,0 +1,4 @@
export { PINNED_FOOTER_TOAST_OFFSET } from './constants';
export { PinnedFooter } from './PinnedFooter';
export type { PinnedFooterLayout, PinnedFooterProps } from './types';
export { pinnedFooterVariants } from './variants';

View File

@ -0,0 +1,19 @@
import type { ComponentPropsWithRef, ReactNode } from 'react';
export type PinnedFooterLayout = 'stack' | 'row';
export type PinnedFooterProps = Omit<
ComponentPropsWithRef<'footer'>,
'children'
> & {
/** The actions, primary first: one block Button, or a row with `layout="row"`. */
children: ReactNode;
/** The figure on the total row's end, usually an `Amount` at `title` size. */
total?: ReactNode;
/** The total row's start, such as «مبلغ قابل پرداخت»; shown only with `total`. */
totalLabel?: ReactNode;
/** A centred caption under the total, such as «با پرداخت، شرایط اشتراک را می‌پذیرید.». */
note?: ReactNode;
/** `stack` (default): total, note and actions in a column; `row`: everything on one line. */
layout?: PinnedFooterLayout;
};

View File

@ -0,0 +1,9 @@
import { cva } from 'class-variance-authority';
/**
* The task flow's bottom bar (DS PinnedFooter): surface over a hairline, 12/16/16 padding plus the
* home indicator's inset, stuck to the bottom of its scrolling column above the content.
*/
export const pinnedFooterVariants = cva(
'sticky bottom-0 z-sticky min-w-0 border-t border-border-subtle bg-surface px-4 pt-3 pb-[max(1rem,env(safe-area-inset-bottom))]',
);

View File

@ -0,0 +1,74 @@
import { FlexBox } from '../../atoms/flex-box';
import { GridBox } from '../../atoms/grid-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import { RESULT_PANEL_ICONS } from './constants';
import type { ResultPanelProps } from './types';
import { resultPanelIconVariants } from './variants';
/**
* The outcome of a flow, centred (DS ResultPanel): a tonal disc, the title, a short body, then
* anything else and the actions. Payment results, a suspended account, registration done, a
* channel that isn't available.
*/
export function ResultPanel({
tone = 'success',
icon,
title,
body,
children,
actions,
tag = 'h1',
titleRef,
role,
className,
}: ResultPanelProps) {
return (
<FlexBox
role={role}
direction="flex-col"
alignItems="items-center"
gap="gap-2"
className={cn('pt-2 text-center', className)}
>
<GridBox
tag="span"
aria-hidden
justifyItems="justify-items-center"
alignItems="items-center"
className={resultPanelIconVariants({ tone })}
>
<Icon
name={icon ?? RESULT_PANEL_ICONS[tone]}
size={36}
strokeWidth={2}
/>
</GridBox>
<Typography
tag={tag}
ref={titleRef}
tabIndex={titleRef ? -1 : undefined}
variant="inherit"
className="m-0 mt-1 text-[1.375rem] leading-[2.125rem] font-bold outline-none"
>
{title}
</Typography>
{body != null && (
<Typography
variant="inherit"
color="secondary"
className="m-0 max-w-105 text-[0.9375rem] leading-[1.625rem]"
>
{body}
</Typography>
)}
{children}
{actions != null && (
<FlexBox direction="flex-col" gap="gap-2" className="mt-4 w-full">
{actions}
</FlexBox>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,11 @@
import type { IconName } from '../../atoms/icon';
import type { ResultPanelTone } from './types';
/** Each tone's icon, unless the caller names another (DS ResultPanel). */
export const RESULT_PANEL_ICONS: Record<ResultPanelTone, IconName> = {
success: 'check',
danger: 'x-circle',
warning: 'clock',
info: 'info',
neutral: 'info',
};

View File

@ -0,0 +1,4 @@
export { RESULT_PANEL_ICONS } from './constants';
export { ResultPanel } from './ResultPanel';
export type { ResultPanelProps, ResultPanelTone } from './types';
export { resultPanelIconVariants } from './variants';

View File

@ -0,0 +1,31 @@
import type { VariantProps } from 'class-variance-authority';
import type { ReactNode, Ref } from 'react';
import type { IconName } from '../../atoms/icon';
import type { resultPanelIconVariants } from './variants';
export type ResultPanelTone = NonNullable<
VariantProps<typeof resultPanelIconVariants>['tone']
>;
export type ResultPanelProps = {
/** success (default), danger, warning, info (the DS `brand`) or neutral. */
tone?: ResultPanelTone;
/** Replaces the tone's icon (check, x-circle, clock, info). */
icon?: IconName;
/** The page's h1, 22/34/700. */
title: ReactNode;
/** 15/26 secondary, at most 420px wide. */
body?: ReactNode;
/** Under the body, such as a receipt or a support link. */
children?: ReactNode;
/** Buttons under everything, stacked full width, primary first. */
actions?: ReactNode;
/** `h1` by default; `h2` when the page already has one. */
tag?: 'h1' | 'h2';
/** A result page moves focus to its title; it then gets `tabIndex={-1}`. */
titleRef?: Ref<HTMLHeadingElement>;
/** `status` for a result that just arrived, `alert` for a failure. */
role?: 'status' | 'alert';
className?: string;
};

View File

@ -0,0 +1,15 @@
import { cva } from 'class-variance-authority';
/** The plain 72px disc in the tone's subtle ground; no ring or dot. `info` is the DS `brand`. */
export const resultPanelIconVariants = cva('size-18 flex-none rounded-full', {
variants: {
tone: {
success: 'bg-success-subtle text-success-text',
danger: 'bg-danger-subtle text-danger-text',
warning: 'bg-warning-subtle text-warning-text',
info: 'bg-action-primary-subtle text-action-primary-text',
neutral: 'bg-surface-sunken text-text-secondary',
},
},
defaultVariants: { tone: 'success' },
});

View File

@ -0,0 +1,77 @@
'use client';
import { useRef, useState } from 'react';
import { Button } from '../../atoms/button';
import { FlexBox } from '../../atoms/flex-box';
import { Icon } from '../../atoms/icon';
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { SearchFieldProps } from './types';
import { searchFieldInputVariants, searchFieldVariants } from './variants';
/**
* A search box (DS SearchField): a `search` landmark pill with the magnifier, the input and a ✕
* once it has text. Enter (the keyboard's search key) calls `onSubmit` and never submits an outer
* form. Controlled with `value`, or keeping its own text.
*/
export function SearchField({
label,
value,
defaultValue = '',
onValueChange,
onSubmit,
clearLabel,
className,
...props
}: SearchFieldProps) {
const [ownValue, setOwnValue] = useState(defaultValue);
const inputRef = useRef<HTMLInputElement>(null);
const text = value ?? ownValue;
const change = (next: string) => {
if (value === undefined) setOwnValue(next);
onValueChange?.(next);
};
return (
<FlexBox
tag="search"
alignItems="items-center"
gap="gap-2"
className={cn(searchFieldVariants(), className)}
>
<Icon name="search" className="flex-none" />
<Element
tag="input"
ref={inputRef}
type="search"
aria-label={label}
enterKeyHint="search"
autoComplete="off"
value={text}
onChange={(event) => change(event.target.value)}
onKeyDown={(event) => {
if (event.key !== 'Enter') return;
event.preventDefault();
onSubmit?.(text.trim());
}}
className={searchFieldInputVariants()}
{...props}
/>
{text !== '' && (
<Button
variant="ghost"
size="sm"
icon="close"
label={clearLabel}
onClick={() => {
change('');
inputRef.current?.focus();
}}
className="-me-2.5 flex-none"
/>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { SearchField } from './SearchField';
export type { SearchFieldProps } from './types';
export { searchFieldInputVariants, searchFieldVariants } from './variants';

View File

@ -0,0 +1,20 @@
import type { ComponentPropsWithoutRef } from 'react';
export type SearchFieldProps = Omit<
ComponentPropsWithoutRef<'input'>,
'type' | 'value' | 'defaultValue' | 'onChange' | 'onSubmit' | 'size'
> & {
/** The field's accessible name, such as «جستجوی تحلیلگر». */
label: string;
/** Controlled: the text now. Leave it out to let the field keep its own. */
value?: string;
defaultValue?: string;
/** Every edit, and '' when cleared. */
onValueChange?: (value: string) => void;
/** Enter or the keyboard's search key, with the trimmed text. */
onSubmit?: (value: string) => void;
/** The ✕'s accessible name, such as «پاک کردن». */
clearLabel: string;
/** On the pill. */
className?: string;
};

View File

@ -0,0 +1,11 @@
import { cva } from 'class-variance-authority';
/** The 44px pill (DS SearchField): its border turns brand with a halo while the input has focus. */
export const searchFieldVariants = cva(
'h-11 w-full min-w-0 rounded-full border border-border-default bg-surface ps-3.5 pe-3.5 text-text-secondary transition-[border-color,box-shadow] duration-120 ease-standard focus-within:border-action-primary focus-within:shadow-focus-field',
);
/** The bare input inside the pill; the browser's own clear and magnifier are hidden. */
export const searchFieldInputVariants = cva(
'h-full min-w-0 flex-1 border-0 bg-transparent p-0 text-[0.9375rem] text-text-primary outline-none placeholder:text-text-tertiary [&::-webkit-search-cancel-button]:appearance-none [&::-webkit-search-decoration]:appearance-none',
);

View File

@ -0,0 +1,59 @@
import { number } from '@lumina/tools/format';
import { FlexBox } from '../../atoms/flex-box';
import { Link } from '../../atoms/link';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import type { SectionTitleProps } from './types';
import { sectionTitleVariants } from './variants';
/**
* A section's title inside a page (DS SectionTitle): the heading, an optional count in secondary,
* and an optional «همه ‹» link at the end. Not the landing's SectionHeading.
*/
export function SectionTitle({
title,
count,
actionLabel,
actionHref,
tag = 'h2',
titleId,
className,
}: SectionTitleProps) {
return (
<FlexBox
alignItems="items-center"
gap="gap-2"
className={cn('min-h-8 min-w-0', className)}
>
<Typography
tag={tag}
id={titleId}
variant="inherit"
className={sectionTitleVariants()}
>
{title}
{count != null && (
<Typography
tag="span"
variant="inherit"
color="secondary"
className="font-semibold"
>
{` (${number(count)})`}
</Typography>
)}
</Typography>
{actionLabel != null && actionHref && (
<Link
href={actionHref}
standalone
icon="chevron-left"
className="flex-none text-caption"
>
{actionLabel}
</Link>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { SectionTitle } from './SectionTitle';
export type { SectionTitleProps } from './types';
export { sectionTitleVariants } from './variants';

View File

@ -0,0 +1,15 @@
import type { ReactNode } from 'react';
export type SectionTitleProps = {
title: ReactNode;
/** Shown after the title in secondary, as «(۱۲)». */
count?: number;
/** A text link at the end with `chevron-left`, such as «همه»; needs `actionHref`. */
actionLabel?: ReactNode;
actionHref?: string;
/** `h2` by default; `h3` under another section heading. */
tag?: 'h2' | 'h3';
/** The heading's id, so its section can be labelled by it. */
titleId?: string;
className?: string;
};

View File

@ -0,0 +1,6 @@
import { cva } from 'class-variance-authority';
/** A section's h2 inside a page (DS SectionTitle): 16/26/700, at least 32px tall with its action. */
export const sectionTitleVariants = cva(
'm-0 min-w-0 flex-1 text-body-md leading-[1.625rem] font-bold',
);

View File

@ -15,7 +15,7 @@ import {
* A one-of choice as chips on a pill track, such as a post's «رایگان» / «پریمیوم» (C4 ۷.۳, C5 ۱.۱,
* ۱.۵, ۱.۶, ۱.۷, ۷.۱). A named radiogroup fieldset of real radios, so Tab reaches the chosen one,
* the arrow keys pick, and disabling the fieldset disables them all. A chosen option fills brand
* with no check.
* with no check, or turns white with `tone="neutral"`.
*/
export function SegmentedChoice<T extends string>({
options,
@ -24,6 +24,8 @@ export function SegmentedChoice<T extends string>({
label,
size = 'md',
track = 'sunken',
tone = 'brand',
block = false,
disabled = false,
frozen = false,
className,
@ -37,20 +39,26 @@ export function SegmentedChoice<T extends string>({
aria-label={label}
disabled={disabled || frozen}
gap="gap-1"
className={cn(segmentedChoiceVariants({ track, frozen }), className)}
className={cn(
segmentedChoiceVariants({ track, frozen, block }),
className,
)}
>
{options.map((option) => (
<FlexBox
key={option.value}
tag="label"
alignItems="items-center"
justifyContent={block ? 'justify-center' : undefined}
className={cn(
segmentedChoiceOptionVariants({
selected: option.value === value,
tone,
size,
disabled: disabled && !frozen,
}),
'gap-1.5',
block && 'flex-1',
)}
>
<Element
@ -63,8 +71,8 @@ export function SegmentedChoice<T extends string>({
readOnly={!onChange}
className="pointer-events-none absolute m-0 size-px opacity-0"
/>
{option.icon && <Icon name={option.icon} size={16} />}
<Typography tag="span" variant="label" color="inherit">
{option.icon && <Icon name={option.icon} size={18} />}
<Typography tag="span" variant="inherit" color="inherit">
{option.label}
</Typography>
</FlexBox>

View File

@ -3,6 +3,7 @@ export type {
SegmentedChoiceOption,
SegmentedChoiceProps,
SegmentedChoiceSize,
SegmentedChoiceTone,
SegmentedChoiceTrack,
} from './types';
export {

View File

@ -15,6 +15,10 @@ export type SegmentedChoiceTrack = NonNullable<
VariantProps<typeof segmentedChoiceVariants>['track']
>;
export type SegmentedChoiceTone = NonNullable<
VariantProps<typeof segmentedChoiceOptionVariants>['tone']
>;
export type SegmentedChoiceOption<T extends string> = {
value: T;
label: ReactNode;
@ -31,8 +35,15 @@ export type SegmentedChoiceProps<T extends string> = {
onChange?: (value: T) => void;
/** The group's accessible name, such as «سطح دسترسی پست». */
label: string;
/** `md` (44px) in forms such as the composer, `sm` (36px) inside a card. */
/** `md` (40px, DS) in forms such as the composer, `sm` (36px) inside a card. */
size?: SegmentedChoiceSize;
/**
* The chosen option: `brand` (default) fills it indigo, for a setting such as «رایگان» /
* «پریمیوم»; `neutral` turns it white with a ring, for a view switch.
*/
tone?: SegmentedChoiceTone;
/** Stretches across its column, each option an equal share. */
block?: boolean;
/** `sunken` on a card or a form; `surface` on a tinted ground, such as the preview banner (C5 ۶.۲). */
track?: SegmentedChoiceTrack;
/** Out of reach for now, such as while the post publishes (C4 ۱.۶): each option dims. */

View File

@ -1,38 +1,64 @@
import { cva } from 'class-variance-authority';
/** The track the options sit in (C5 ۱.۱); frozen, it dims as one (C5 ۱.۶). */
/**
* The track the options sit in (C5 ۱.۱; DS Segmented); frozen, it dims as one (C5 ۱.۶). `block`
* stretches it across its column, each option taking an equal share.
*/
export const segmentedChoiceVariants = cva(
'w-fit min-w-0 rounded-full border border-border-subtle p-1',
'min-w-0 rounded-full border border-border-subtle p-1',
{
variants: {
/** sunken on a card or a form; surface on a tinted ground, such as a banner (C5 ۶.۲). */
track: { sunken: 'bg-surface-sunken', surface: 'bg-surface' },
frozen: { true: 'frozen', false: '' },
block: { true: 'w-full', false: 'w-fit' },
},
defaultVariants: { track: 'sunken', frozen: false },
defaultVariants: { track: 'sunken', frozen: false, block: false },
},
);
/**
* One option, a chip with the real radio hidden inside: filled brand when chosen, bare on the
* track when not. The label is the hit area and shows the radio's keyboard focus.
* One option, a pill with the real radio hidden inside: 40px at 15/600 (DS), secondary when not
* chosen. Chosen, it fills brand (`tone="brand"`), or turns white with a hairline ring and a
* shadow (`tone="neutral"`, for a view switch rather than a setting). The label is the hit area and
* shows the radio's keyboard focus.
*/
export const segmentedChoiceOptionVariants = cva(
'relative rounded-full border whitespace-nowrap transition-colors duration-120 ease-standard has-[input:enabled]:cursor-pointer has-[input:focus-visible]:focus-ring',
'relative rounded-full border border-transparent font-semibold whitespace-nowrap transition-colors duration-120 ease-standard has-[input:enabled]:cursor-pointer has-[input:focus-visible]:focus-ring',
{
variants: {
selected: {
true: 'border-action-primary bg-action-primary text-text-on-action',
true: '',
false:
'border-transparent bg-transparent text-text-primary has-[input:enabled]:hover:border-action-primary',
'bg-transparent text-text-secondary has-[input:enabled]:hover:text-text-primary',
},
tone: { brand: '', neutral: '' },
size: {
sm: 'min-h-control-sm px-3.5',
md: 'min-h-control-md px-4',
sm: 'min-h-control-sm px-3.5 text-body-sm leading-6',
md: 'min-h-10 px-4 text-[0.9375rem] leading-6',
},
/** Disabled but not frozen: each option dims, as a disabled chip does (C4 ۱.۶). */
disabled: { true: 'frozen', false: '' },
},
defaultVariants: { selected: false, size: 'md', disabled: false },
compoundVariants: [
{
selected: true,
tone: 'brand',
className:
'border-action-primary bg-action-primary text-text-on-action',
},
{
selected: true,
tone: 'neutral',
className:
'bg-surface text-text-primary shadow-[0_0_0_1px_var(--border-default),var(--shadow-1)]',
},
],
defaultVariants: {
selected: false,
tone: 'brand',
size: 'md',
disabled: false,
},
},
);

View File

@ -0,0 +1,57 @@
import { FlexBox } from '../../atoms/flex-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import { cn } from '../../tools/cn';
import type { StatTileProps } from './types';
import { statTileValueVariants, statTileVariants } from './variants';
/**
* One figure with its label (DS StatTile), such as a balance or a count on a dashboard: the label
* with an icon, the value, then an optional meter and hint.
*/
export function StatTile({
label,
icon,
value,
valueTone,
hint,
children,
tone,
className,
}: StatTileProps) {
return (
<FlexBox
direction="flex-col"
className={cn(statTileVariants({ tone }), 'gap-1.5', className)}
>
<FlexBox
alignItems="items-center"
className="gap-1.5 text-text-secondary"
>
{icon && <Icon name={icon} size={16} />}
<Typography
tag="span"
variant="caption"
color="inherit"
className="font-semibold"
>
{label}
</Typography>
</FlexBox>
<Typography
tag="span"
variant="inherit"
color="inherit"
className={statTileValueVariants({ valueTone })}
>
{value}
</Typography>
{children}
{hint != null && (
<Typography tag="span" variant="caption" color="secondary">
{hint}
</Typography>
)}
</FlexBox>
);
}

View File

@ -0,0 +1,3 @@
export { StatTile } from './StatTile';
export type { StatTileProps, StatTileTone, StatTileValueTone } from './types';
export { statTileValueVariants, statTileVariants } from './variants';

View File

@ -0,0 +1,29 @@
import type { VariantProps } from 'class-variance-authority';
import type { ReactNode } from 'react';
import type { IconName } from '../../atoms/icon';
import type { statTileValueVariants, statTileVariants } from './variants';
export type StatTileTone = NonNullable<
VariantProps<typeof statTileVariants>['tone']
>;
export type StatTileValueTone = NonNullable<
VariantProps<typeof statTileValueVariants>['valueTone']
>;
export type StatTileProps = {
/** 13/600 secondary, such as «قابل واریز». */
label: ReactNode;
/** 16px before the label. */
icon?: IconName;
/** The figure: text at 24/700, or an `Amount` at `title` size. */
value: ReactNode;
valueTone?: StatTileValueTone;
/** 13/22 secondary under the value, such as «واریز بعدی: ۱۵ مهر». */
hint?: ReactNode;
/** Between the value and the hint, such as a Meter. */
children?: ReactNode;
tone?: StatTileTone;
className?: string;
};

View File

@ -0,0 +1,25 @@
import { cva } from 'class-variance-authority';
/** `card`: a bordered radius-lg surface; `soft`: sunken with no border (DS StatTile). */
export const statTileVariants = cva('min-w-0 rounded-lg border p-4', {
variants: {
tone: {
card: 'border-border-subtle bg-surface',
soft: 'border-transparent bg-surface-sunken',
},
},
defaultVariants: { tone: 'card' },
});
/** The figure, 24/36/700, in a status hue when it carries one. */
export const statTileValueVariants = cva('text-[1.5rem] leading-9 font-bold', {
variants: {
valueTone: {
default: 'text-text-primary',
success: 'text-success-text',
danger: 'text-danger-text',
warning: 'text-warning-text',
},
},
defaultVariants: { valueTone: 'default' },
});

View File

@ -22,6 +22,9 @@ export const textInputBoxVariants = cva(
*/
locked:
'border-border-subtle bg-surface-sunken focus-within:border-border-default',
/** A checked, accepted value, such as a valid invite code (CodeInput): green, focused or not. */
valid:
'border-success bg-surface focus-within:shadow-focus-field-success',
},
frozen: { true: 'frozen', false: '' },
},

View File

@ -0,0 +1,13 @@
import { Element } from '../../primitives/element';
import { cn } from '../../tools/cn';
import type { TimelineProps } from './types';
import { timelineVariants } from './variants';
/** Steps or events in order (DS Timeline), such as the install-app steps; holds TimelineItems. */
export function Timeline({ className, children, ...props }: TimelineProps) {
return (
<Element tag="ol" className={cn(timelineVariants(), className)} {...props}>
{children}
</Element>
);
}

View File

@ -0,0 +1,62 @@
import { FlexBox } from '../../atoms/flex-box';
import { GridBox } from '../../atoms/grid-box';
import { Icon } from '../../atoms/icon';
import { Typography } from '../../atoms/typography';
import type { TimelineItemProps } from './types';
import { timelineDotVariants, timelineItemVariants } from './variants';
/** One step of a Timeline: a tonal dot on the connector, then the title, body and time. */
export function TimelineItem({
title,
body,
time,
children,
tone,
icon = 'check',
step,
}: TimelineItemProps) {
return (
<FlexBox tag="li" gap="gap-3" className={timelineItemVariants()}>
<GridBox
tag="span"
aria-hidden
justifyItems="justify-items-center"
alignItems="items-center"
className={timelineDotVariants({ tone })}
>
{step != null ? (
<Typography
tag="span"
variant="caption"
color="inherit"
className="font-bold"
>
{step}
</Typography>
) : (
<Icon name={icon} size={14} strokeWidth={2.25} />
)}
</GridBox>
<FlexBox direction="flex-col" className="min-w-0 flex-1 gap-0.5 pt-0.5">
<Typography variant="body-sm" className="m-0 font-semibold">
{title}
</Typography>
{body != null && (
<Typography variant="caption" color="secondary" className="m-0">
{body}
</Typography>
)}
{children}
{time != null && (
<Typography
variant="inherit"
color="tertiary"
className="m-0 text-[0.75rem] leading-5"
>
{time}
</Typography>
)}
</FlexBox>
</FlexBox>
);
}

View File

@ -0,0 +1,8 @@
export { Timeline } from './Timeline';
export { TimelineItem } from './TimelineItem';
export type { TimelineItemProps, TimelineProps, TimelineTone } from './types';
export {
timelineDotVariants,
timelineItemVariants,
timelineVariants,
} from './variants';

View File

@ -0,0 +1,31 @@
import type { VariantProps } from 'class-variance-authority';
import type { ComponentPropsWithRef, ReactNode } from 'react';
import type { IconName } from '../../atoms/icon';
import type { timelineDotVariants } from './variants';
export type TimelineTone = NonNullable<
VariantProps<typeof timelineDotVariants>['tone']
>;
export type TimelineProps = Omit<ComponentPropsWithRef<'ol'>, 'children'> & {
/** TimelineItems, in order. */
children: ReactNode;
};
export type TimelineItemProps = {
/** 14/600, such as «دکمه اشتراک‌گذاری را بزنید». */
title: ReactNode;
/** 13/22 secondary under the title. */
body?: ReactNode;
/** 12/20 tertiary, last, such as a date. */
time?: ReactNode;
/** Anything else, between the body and the time. */
children?: ReactNode;
/** The dot's tone: neutral by default. */
tone?: TimelineTone;
/** The dot's icon; `check` by default. */
icon?: IconName;
/** A step number in the dot instead of the icon, such as «۱». */
step?: ReactNode;
};

View File

@ -0,0 +1,29 @@
import { cva } from 'class-variance-authority';
/** The ordered list: no bullets or indent. */
export const timelineVariants = cva('m-0 min-w-0 list-none p-0');
/**
* One step: 16px under it, and a 2px connector from under its dot to the next step's. The last
* step has neither.
*/
export const timelineItemVariants = cva(
'relative pb-4 last:pb-0 before:absolute before:start-3.25 before:top-7 before:bottom-0 before:w-0.5 before:bg-border-subtle last:before:hidden',
);
/** The 28px dot in the step's tone. */
export const timelineDotVariants = cva(
'relative size-7 flex-none rounded-full',
{
variants: {
tone: {
neutral: 'bg-surface-sunken text-text-secondary',
brand: 'bg-action-primary-subtle text-action-primary-text',
success: 'bg-success-subtle text-success-text',
danger: 'bg-danger-subtle text-danger-text',
warning: 'bg-warning-subtle text-warning-text',
},
},
defaultVariants: { tone: 'neutral' },
},
);

View File

@ -0,0 +1,13 @@
'use client';
import { useToastPlacement } from './hooks/use-toast-placement';
import type { ToastPlacementMarkerProps } from './types';
/**
* `useToastPlacement` for a server layout or template: renders nothing and declares its edge while
* it is mounted, such as `desktop` in the desktop app's root layout.
*/
export function ToastPlacementMarker({ placement }: ToastPlacementMarkerProps) {
useToastPlacement(placement);
return null;
}

View File

@ -4,9 +4,12 @@ import { useEffect, useState, useSyncExternalStore } from 'react';
import type { CSSProperties } from 'react';
import { createPortal } from 'react-dom';
import { Toaster as SonnerToaster } from 'sonner';
import { useStore } from 'zustand';
import { DIALOG_CLOSE_EVENT, DIALOG_OPEN_EVENT } from '../../atoms/dialog';
import { TOAST_OFFSETS } from './constants';
import { CloseLabelContext } from './hooks/use-close-label';
import { resolveToastPlacement, toastPlacementStore } from './placement-store';
import { syncKeyboardFocus, trackToastRegion } from './region-store';
import type { ToasterProps } from './types';
@ -34,14 +37,22 @@ const TOAST_SLOT_STYLE = {
* `data-removed` on the slot and unmounts it 200ms later (sonner 2.0.8), so the toast inside plays
* its 160ms exit. The toast sits two wrappers down, so the selector looks for `[data-toast]`.
*/
/**
* A pinned footer on screen (`data-pinned-footer`) lifts the toasts above it, wherever it is
* rendered: the box carries the footer's offset (`PINNED_FOOTER_TOAST_OFFSET`, 152px) only then.
*/
const FOOTER_AWARE_CLASS =
'[:root:has([data-pinned-footer])_&]:[--toast-footer-offset:152px]';
const TOAST_SLOT_CLASS =
'data-[removed=true]:pointer-events-none data-[removed=true]:[&_[data-toast]]:animate-toast-out';
/**
* The one toast region, rendered once by the app shell. Bottom centre, 24px from the bottom
* (sonner would use 16px on phones), never at the top. Bull shows the bottom nav up to 1024px, so
* while the nav or a pinned footer is visible the shell passes both `offset` and `mobileOffset`
* with its height plus 24px.
* The one toast region, rendered once by the app shell. Bottom centre, never at the top, 16px from
* the sides on a phone and at most 420px wide. Its distance from the bottom follows the edges the
* screen declares with `useToastPlacement` (`TOAST_OFFSETS`): above the bottom nav (80px) or a
* pinned footer (152px), low (24px) on a task page and over an open sheet, which covers both, and
* 32px in the desktop app whatever else is on screen. `placement` forces one, for previews.
*
* Sheets and modals are `<dialog>`s in the browser's top layer, above every z-index, and they make
* the rest of the page inert. So the region lives in a box of its own that moves into the topmost
@ -50,16 +61,36 @@ const TOAST_SLOT_CLASS =
* The lightbox doesn't host toasts, so it stays above them. The box also reports the pointer and
* keyboard focus on the region, which pause the toasts' clocks.
*/
export function Toaster({ label, closeLabel, style, ...props }: ToasterProps) {
export function Toaster({
label,
closeLabel,
placement,
style,
...props
}: ToasterProps) {
// The box exists only in the browser; the region renders after hydration, as sonner does anyway.
const [box] = useState(() =>
typeof document === 'undefined' ? null : document.createElement('div'),
);
const [box] = useState(() => {
if (typeof document === 'undefined') return null;
const element = document.createElement('div');
element.className = FOOTER_AWARE_CLASS;
return element;
});
const isHydrated = useSyncExternalStore(
noSubscription,
() => true,
() => false,
);
const declared = useStore(toastPlacementStore, resolveToastPlacement);
// The region is inside an open sheet or modal, which covers the nav and any footer.
const [isInDialog, setInDialog] = useState(false);
const resolved = placement ?? declared;
const settled = isInDialog && resolved !== 'desktop' ? 'low' : resolved;
const offset = `${TOAST_OFFSETS[settled]}px`;
// A pinned footer can't sit under a dialog's toasts or in the desktop app's way.
const bottom =
settled === 'desktop' || isInDialog
? offset
: `var(--toast-footer-offset, ${offset})`;
useEffect(() => {
if (!box) return undefined;
@ -68,6 +99,7 @@ export function Toaster({ label, closeLabel, style, ...props }: ToasterProps) {
const stack: HTMLDialogElement[] = [];
const place = () => {
(stack.at(-1) ?? document.body).append(box);
setInDialog(stack.length > 0);
// Moving the box drops the focus inside it without a focusout.
syncKeyboardFocus();
};
@ -100,8 +132,8 @@ export function Toaster({ label, closeLabel, style, ...props }: ToasterProps) {
<CloseLabelContext value={closeLabel}>
<SonnerToaster
position="bottom-center"
offset={24}
mobileOffset={24}
offset={{ bottom }}
mobileOffset={{ bottom }}
gap={8}
containerAriaLabel={label}
toastOptions={{

View File

@ -1,5 +1,6 @@
import type { IconName } from '../../atoms/icon';
import type { ToastTone } from './types';
import { PINNED_FOOTER_TOAST_OFFSET } from '../pinned-footer';
import type { ToastPlacement, ToastTone } from './types';
export const TOAST_ICONS: Record<ToastTone, IconName> = {
info: 'info',
@ -16,3 +17,14 @@ export const TOAST_DURATION_MS = 4000;
export const TOAST_WITH_ACTION_DURATION_MS = 6000;
export const TOAST_ERROR_DURATION_MS = 8000;
export const TOAST_ERROR_WITH_ACTION_DURATION_MS = 10000;
/**
* Each placement's distance from the bottom edge, in px: clear of the 64px bottom nav, of a pinned
* footer with one button and its note, near the edge on a task page or a sheet, and on desktop.
*/
export const TOAST_OFFSETS: Record<ToastPlacement, number> = {
nav: 80,
footer: PINNED_FOOTER_TOAST_OFFSET,
low: 24,
desktop: 32,
};

View File

@ -0,0 +1,22 @@
'use client';
import { useEffect } from 'react';
import { declareToastPlacement } from '../placement-store';
import type { DeclaredToastPlacement } from '../types';
/**
* Declares, while the calling part is on screen and `active`, the bottom edge the toasts must sit
* above: `nav` (the mobile bottom nav, 80px), `footer` (a pinned footer, 152px) or `desktop` (the
* desktop app, centred at 32px). With none declared they sit low (24px), as on a task page or over
* a sheet.
*/
export function useToastPlacement(
placement: DeclaredToastPlacement,
active = true,
): void {
useEffect(() => {
if (!active) return undefined;
return declareToastPlacement(placement);
}, [placement, active]);
}

View File

@ -1,10 +1,16 @@
export { TOAST_OFFSETS } from './constants';
export { useToastPlacement } from './hooks/use-toast-placement';
export { dismissToast, showToast } from './show-toast';
export { Toast } from './Toast';
export { Toaster } from './Toaster';
export { ToastPlacementMarker } from './ToastPlacementMarker';
export type {
DeclaredToastPlacement,
ShowToastOptions,
ToastAction,
ToasterProps,
ToastPlacement,
ToastPlacementMarkerProps,
ToastProps,
ToastTone,
} from './types';

Some files were not shown because too many files have changed in this diff Show More