themelia-react-ui 0.0.0-stage → 1.0.1

package/dist/components/layout/sidebar/sidebar.types.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Sidebar types — framework-neutral navigation tree, render contexts, slots,
+ * strings, and composition props.
+ */
+import type { ComponentType, ReactNode } from 'react';
+import type { LayoutIconSource, LayoutLinkRenderer, LayoutNavigationAdapter } from '../layout.types';
+import type { SidebarMenuDensity } from '../../base/sidebar';
+import type { StringsProp } from '../../../lib/strings';
+export interface SidebarNavItem {
+    /** Display label. */
+    label: ReactNode;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    handle?: string;
+    /** Leading glyph. */
+    icon?: LayoutIconSource;
+    /** Disables this entry and every descendant, including branches exposed by search. */
+    disabled?: boolean;
+    /** Chip rendered beside the label. */
+    badge?: string | number;
+    children?: SidebarNavItem[];
+    group?: string;
+    external?: boolean;
+}
+export type SidebarFlatNavItem = Omit<SidebarNavItem, 'children' | 'group'>;
+export interface SidebarRenderItemContext {
+    depth: number;
+    /** Marks the control as currently engaged. */
+    active: boolean;
+    expanded: boolean;
+    /** Effective disabled state, including any disabled ancestor. */
+    disabled?: boolean;
+    /** Library-owned child list when this branch is expanded. Place it after the custom row. */
+    children?: ReactNode;
+    /** Available for custom branch renderers. */
+    setExpanded?: (expanded: boolean) => void;
+    /** Chip rendered beside the label. */
+    badge?: string | number;
+    renderLink: LayoutLinkRenderer;
+}
+export interface SidebarSlots {
+    /** Header region of the shell. */
+    header?: ReactNode;
+    beforeNavigation?: ReactNode;
+    afterNavigation?: ReactNode;
+    /** Content below the body. */
+    footer?: ReactNode;
+    empty?: ReactNode;
+    /** Shows the pending indicator. */
+    loading?: ReactNode;
+}
+export interface SidebarExpansionProps {
+    /** Expanded branch keys from handle, href, or a plain-text label. Controlled. */
+    expandedItems?: readonly string[];
+    /** Initially expanded branches. Active ancestors also open automatically. */
+    defaultExpandedItems?: readonly string[];
+    /** Called after a disclosure changes; navigation remains independent. */
+    onExpandedItemsChange?: (keys: string[]) => void;
+}
+export interface SidebarNavigationStrings {
+    search: string;
+    noResults: string;
+    expand: (label: string) => string;
+    collapse: (label: string) => string;
+}
+export declare const defaultSidebarNavigationStrings: SidebarNavigationStrings;
+export interface AppSidebarProps extends LayoutNavigationAdapter, SidebarExpansionProps {
+    /** Enables the library input and local navigation filtering. */
+    searchable?: boolean;
+    /** Search text. Controlled; renderNode labels use their handle as searchable text. */
+    searchValue?: string;
+    defaultSearchValue?: string;
+    onSearchValueChange?: (value: string) => void;
+    /** Navigation search and disclosure copy. */
+    strings?: StringsProp<SidebarNavigationStrings>;
+    /** Row and child-list rhythm. Inherits the sidebar provider. */
+    menuDensity?: SidebarMenuDensity;
+    /** Navigation items grouped by section heading. */
+    navigationGroups?: Record<string, SidebarNavItem[]>;
+    /** Navigation items pinned to the sidebar footer. */
+    footerNavItems?: SidebarFlatNavItem[];
+    /** Heading above the footer navigation. */
+    footerLabel?: ReactNode;
+    /** Full product mark, shown when expanded. */
+    logo?: ReactNode;
+    /** Compact mark, shown when the sidebar collapses to icons. */
+    collapsedLogo?: ReactNode;
+    /** Links offered in the workspace switcher. */
+    workspaceLinks?: WorkspaceLink[];
+    /** Copy overrides for the workspace switcher. */
+    workspaceStrings?: StringsProp<SidebarWorkspaceDropdownStrings>;
+    /** Merged onto the workspace switcher content. */
+    workspaceContentClassName?: string;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    /** Merged onto the logo. */
+    logoClassName?: string;
+    /** Resolves an item's icon name to a component, keeping navigation data serialisable. */
+    iconMap?: Record<string, ComponentType<{
+        className?: string;
+    }>>;
+    /** URL of the active route, used to mark the current item. */
+    currentUrl?: string;
+    /** Render item badges and live counts. @default true */
+    showBadges?: boolean;
+    /** Live counts keyed by item id — unread totals and similar. */
+    liveBadges?: Record<string, string | number>;
+    /** Shows the pending indicator. */
+    loading?: boolean;
+    /** Whether the sidebar can collapse to icons. */
+    collapsible?: 'offcanvas' | 'icon' | 'none';
+    /** Shell treatment. */
+    variant?: 'sidebar' | 'floating' | 'inset';
+    /** Which side of the trigger the surface opens on. */
+    side?: 'left' | 'right';
+    className?: string;
+    /** Merged onto the sidebar surface. */
+    surfaceClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Replaces individual regions of the shell. */
+    slots?: SidebarSlots;
+    /** Renders one item through the consumer's router. */
+    renderItem?: (item: SidebarNavItem, context: SidebarRenderItemContext) => ReactNode;
+}
+export interface SidebarGroupedNavigationProps extends LayoutNavigationAdapter, SidebarExpansionProps {
+    /** Optional local filter. Matching ancestors stay visible and open. */
+    searchValue?: string;
+    strings?: StringsProp<SidebarNavigationStrings>;
+    /** Row and child-list rhythm. Inherits the sidebar provider. */
+    menuDensity?: SidebarMenuDensity;
+    /** Navigation items grouped by section heading. */
+    navigationByGroups: Record<string, SidebarNavItem[]>;
+    /** URL of the active route, used to mark the current item. */
+    currentUrl?: string;
+    /** Resolves an item's icon name to a component, keeping navigation data serialisable. */
+    iconMap?: Record<string, ComponentType<{
+        className?: string;
+    }>>;
+    /** Render item badges and live counts. @default true */
+    showBadges?: boolean;
+    /** Live counts keyed by item id — unread totals and similar. */
+    liveBadges?: Record<string, string | number>;
+    /** Shown when a group has no items. */
+    emptySlot?: ReactNode;
+    /** Renders one item through the consumer's router. */
+    renderItem?: (item: SidebarNavItem, context: SidebarRenderItemContext) => ReactNode;
+    className?: string;
+}
+export interface SidebarFlatNavigationProps extends LayoutNavigationAdapter {
+    /** Row and child-list rhythm. Inherits the sidebar provider. */
+    menuDensity?: SidebarMenuDensity;
+    /** Entries to render, in order. */
+    items: SidebarFlatNavItem[];
+    /** Display label. */
+    label?: ReactNode;
+    /** URL of the active route, used to mark the current item. */
+    currentUrl?: string;
+    /** Resolves an item's icon name to a component, keeping navigation data serialisable. */
+    iconMap?: Record<string, ComponentType<{
+        className?: string;
+    }>>;
+    /** Render item badges and live counts. @default true */
+    showBadges?: boolean;
+    /** Live counts keyed by item id — unread totals and similar. */
+    liveBadges?: Record<string, string | number>;
+    /** Renders one item through the consumer's router. */
+    renderItem?: (item: SidebarFlatNavItem, context: SidebarRenderItemContext) => ReactNode;
+    className?: string;
+}
+export interface WorkspaceLink {
+    /** Display label. */
+    label: ReactNode;
+    url: string;
+    /** Leading glyph. */
+    icon?: ComponentType<{
+        className?: string;
+    }>;
+    external?: boolean;
+}
+export interface SidebarWorkspaceDropdownStrings {
+    /** Display label. */
+    label: string;
+    select: string;
+}
+export declare const defaultSidebarWorkspaceDropdownStrings: SidebarWorkspaceDropdownStrings;
+export interface SidebarWorkspaceDropdownProps extends LayoutNavigationAdapter {
+    /** Full product mark, shown when expanded. */
+    logo: ReactNode;
+    /** Compact mark, shown when the sidebar collapses to icons. */
+    collapsedLogo?: ReactNode;
+    /** Links offered in the workspace switcher. */
+    workspaceLinks: WorkspaceLink[];
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<SidebarWorkspaceDropdownStrings>;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+}
+export type SidebarFooterNavigationItem = SidebarFlatNavItem;
+export interface SidebarNavigationFooterProps extends LayoutNavigationAdapter {
+    /** Row and child-list rhythm. Inherits the sidebar provider. */
+    menuDensity?: SidebarMenuDensity;
+    /** Entries to render, in order. */
+    items: SidebarFooterNavigationItem[];
+    /** Display label. */
+    label?: ReactNode;
+    /** URL of the active route, used to mark the current item. */
+    currentUrl?: string;
+    /** Resolves an item's icon name to a component, keeping navigation data serialisable. */
+    iconMap?: Record<string, ComponentType<{
+        className?: string;
+    }>>;
+    /** Render item badges and live counts. @default true */
+    showBadges?: boolean;
+    /** Live counts keyed by item id — unread totals and similar. */
+    liveBadges?: Record<string, string | number>;
+    className?: string;
+}

package/dist/components/layout/sidebar/sidebar.utils.d.ts

@@ -0,0 +1,29 @@
+/** Sidebar utilities — pure path helpers, labels, icon rendering, badge pill. */
+import * as React from 'react';
+import type { LayoutIconSource, LayoutLinkRenderer } from '../layout.types';
+import type { SidebarNavItem } from './sidebar.types';
+import type { ComponentScale } from '../../../lib/component-vocabulary';
+export declare function toPath(href: string): string;
+export declare function isPathMatch(currentUrl: string, path: string): boolean;
+export declare function getNavLabel(item: Pick<SidebarNavItem, 'label'>): React.ReactNode;
+export declare function getNavKey(item: SidebarNavItem, fallbackIndex?: number): React.Key;
+export declare function NavBadge({ value, size, }: {
+    /** Current value. Controlled. */
+    value: string | number;
+    /** Size preset. */
+    size?: ComponentScale;
+}): React.JSX.Element;
+export declare function resolveNavBadge(handle: string | undefined, itemBadge: string | number | undefined, liveBadges: Record<string, string | number> | undefined): string | number | undefined;
+export interface DynamicIconProps extends React.SVGProps<SVGSVGElement> {
+    /** Leading glyph. */
+    icon: LayoutIconSource;
+    /** Resolves an item's icon name to a component, keeping navigation data serialisable. */
+    iconMap?: Record<string, React.ComponentType<{
+        className?: string;
+    }>>;
+    /** Size preset. */
+    size?: number;
+    className?: string;
+}
+export declare function DynamicIcon({ icon, iconMap, size, className, ...props }: DynamicIconProps): React.JSX.Element | null;
+export declare function renderSidebarLink(renderLink: LayoutLinkRenderer, item: SidebarNavItem, children: React.ReactNode, className?: string, active?: boolean): React.ReactNode;

package/dist/components/layout/workspace/index.d.ts

@@ -0,0 +1,3 @@
+export { WorkspaceLayout, WorkspaceLocaleStrip, WorkspaceNav, WorkspaceRecordHeader, } from './workspace';
+export type { WorkspaceContentWidth, WorkspaceLayoutProps, WorkspaceLayoutStyle, WorkspaceLocaleItem, WorkspaceLocaleStripProps, WorkspaceNavGroup, WorkspaceNavItem, WorkspaceNavItemStatus, WorkspaceNavProps, WorkspaceNavRenderContext, WorkspaceRecordHeaderMetadataItem, WorkspaceRecordHeaderProps, } from './workspace.types';
+export { defaultWorkspaceLocaleStripStrings, defaultWorkspaceNavStrings, defaultWorkspaceRecordHeaderStrings, type WorkspaceLocaleStripStrings, type WorkspaceNavStrings, type WorkspaceRecordHeaderStrings, } from './workspace.strings';

package/dist/components/layout/workspace/workspace.d.ts

@@ -0,0 +1,6 @@
+import * as React from 'react';
+import type { WorkspaceLayoutProps, WorkspaceLocaleStripProps, WorkspaceNavProps, WorkspaceRecordHeaderProps } from './workspace.types';
+export declare const WorkspaceLayout: React.ForwardRefExoticComponent<WorkspaceLayoutProps & React.RefAttributes<HTMLDivElement>>;
+export declare const WorkspaceRecordHeader: React.ForwardRefExoticComponent<WorkspaceRecordHeaderProps & React.RefAttributes<HTMLDivElement>>;
+export declare const WorkspaceNav: React.ForwardRefExoticComponent<WorkspaceNavProps & React.RefAttributes<HTMLElement>>;
+export declare const WorkspaceLocaleStrip: React.ForwardRefExoticComponent<WorkspaceLocaleStripProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/layout/workspace/workspace.strings.d.ts

@@ -0,0 +1,18 @@
+export interface WorkspaceRecordHeaderStrings {
+    metadataLabel: string;
+    actionsLabel: string;
+    secondaryActionsLabel: string;
+}
+export declare const defaultWorkspaceRecordHeaderStrings: WorkspaceRecordHeaderStrings;
+export interface WorkspaceNavStrings {
+    ariaLabel: string;
+    completionLabel: (value: number) => string;
+    currentLabel: string;
+}
+export declare const defaultWorkspaceNavStrings: WorkspaceNavStrings;
+export interface WorkspaceLocaleStripStrings {
+    ariaLabel: string;
+    activeLabel: string;
+    completionLabel: (value: number) => string;
+}
+export declare const defaultWorkspaceLocaleStripStrings: WorkspaceLocaleStripStrings;

package/dist/components/layout/workspace/workspace.types.d.ts

@@ -0,0 +1,141 @@
+import type { CSSProperties, HTMLAttributes, MouseEvent, ReactNode } from 'react';
+import type { LayoutIconComponent, LayoutNavigationAdapter } from '../layout.types';
+import type { StringsProp } from '../../../lib/strings';
+import type { WorkspaceLocaleStripStrings, WorkspaceNavStrings, WorkspaceRecordHeaderStrings } from './workspace.strings';
+export type WorkspaceContentWidth = 'default' | 'wide' | 'full';
+export interface WorkspaceLayoutStyle extends CSSProperties {
+    '--workspace-sidebar-width'?: string;
+    '--workspace-rail-width'?: string;
+    '--workspace-content-max-width'?: string;
+}
+export interface WorkspaceLayoutProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Header region of the shell. */
+    header?: ReactNode;
+    /** Sidebar region of the shell. */
+    sidebar?: ReactNode;
+    /** Narrow icon rail beside the sidebar. */
+    rail?: ReactNode;
+    children: ReactNode;
+    /** Maximum width of the content column. */
+    contentWidth?: WorkspaceContentWidth;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    /** Merged onto the body region. */
+    bodyClassName?: string;
+    /** Merged onto the sidebar region. */
+    sidebarClassName?: string;
+    /** Merged onto the main region. */
+    mainClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Merged onto the icon rail. */
+    railClassName?: string;
+    /** Accessible name for the region. */
+    ariaLabel?: string;
+    style?: WorkspaceLayoutStyle;
+}
+export interface WorkspaceRecordHeaderMetadataItem {
+    id?: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Current value. Controlled. */
+    value: ReactNode;
+}
+export interface WorkspaceRecordHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Surface title. */
+    title: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Chips shown beside the record title. */
+    badges?: ReactNode;
+    /** Label/value facts under the record title. */
+    metadata?: WorkspaceRecordHeaderMetadataItem[];
+    /** Controls offered on the surface. */
+    actions?: ReactNode;
+    /** Lower-emphasis controls beside the primary action. */
+    secondaryActions?: ReactNode;
+    /** Current state, shown as a chip. */
+    status?: ReactNode;
+    /** Illustration or imagery beside the form. */
+    media?: ReactNode;
+    /** Content at the end of the header. */
+    headerEnd?: ReactNode;
+    /** Replaces the record title region. */
+    titleSlot?: ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<WorkspaceRecordHeaderStrings>;
+}
+export type WorkspaceNavItemStatus = 'complete' | 'current' | 'attention' | 'disabled' | 'idle';
+export interface WorkspaceNavItem {
+    id: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    /** Leading glyph. */
+    icon?: LayoutIconComponent;
+    /** Chip rendered beside the label. */
+    badge?: ReactNode;
+    completion?: number;
+    /** Current state, shown as a chip. */
+    status?: WorkspaceNavItemStatus;
+    /** Disables the control. */
+    disabled?: boolean;
+    warning?: boolean;
+    external?: boolean;
+    target?: string;
+    rel?: string;
+}
+export interface WorkspaceNavGroup {
+    id: string;
+    /** Display label. */
+    label?: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Entries to render, in order. */
+    items: WorkspaceNavItem[];
+}
+export interface WorkspaceNavRenderContext {
+    /** Marks the control as currently engaged. */
+    active: boolean;
+    group: WorkspaceNavGroup;
+    index: number;
+    onSelect?: (event: MouseEvent<HTMLElement>) => void;
+}
+export interface WorkspaceNavProps extends Omit<HTMLAttributes<HTMLElement>, 'onSelect'>, LayoutNavigationAdapter {
+    /** Sections of the settings navigation. */
+    groups: WorkspaceNavGroup[];
+    /** Id of the active entry. */
+    activeId?: string;
+    onSelect?: (item: WorkspaceNavItem) => void;
+    /** Renders one item through the consumer's router. */
+    renderItem?: (item: WorkspaceNavItem, context: WorkspaceNavRenderContext) => ReactNode;
+    footerSlot?: ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<WorkspaceNavStrings>;
+}
+export interface WorkspaceLocaleItem {
+    id: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    completion?: number;
+    /** Current state, shown as a chip. */
+    status?: ReactNode;
+    /** Disables the control. */
+    disabled?: boolean;
+}
+export interface WorkspaceLocaleStripProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    locales: WorkspaceLocaleItem[];
+    activeLocale?: string;
+    onLocaleChange?: (locale: WorkspaceLocaleItem) => void;
+    /** Controls offered on the surface. */
+    actions?: ReactNode;
+    /** Current state, shown as a chip. */
+    status?: ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<WorkspaceLocaleStripStrings>;
+}

package/dist/components/primitives/date.d.ts

@@ -0,0 +1,63 @@
+import { type ComponentPropsWithoutRef, type ReactNode, type Ref } from 'react';
+import { type Locale } from 'date-fns';
+import { type TextProps } from '../typography';
+import type { TextSize } from '../../lib/ui-provider';
+type NativeDate = InstanceType<typeof globalThis.Date>;
+export type DateInput = NativeDate | string | number | null | undefined;
+type SpanProps = Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'color'>;
+export type DatePreset = 'compact' | 'short' | 'medium' | 'long';
+export interface DateProps extends SpanProps {
+    value?: DateInput;
+    format?: string;
+    preset?: DatePreset;
+    locale?: Locale;
+    emptyLabel?: ReactNode;
+    size?: TextSize;
+    align?: TextProps['align'];
+    weight?: TextProps['weight'];
+    type?: TextProps['type'];
+    ref?: Ref<HTMLSpanElement>;
+}
+export interface TimeProps extends Omit<DateProps, 'preset'> {
+    preset?: 'short' | 'medium';
+}
+export interface DateTimeProps extends DateProps {
+    timeFormat?: string;
+}
+export interface DateRangeValue {
+    from?: DateInput;
+    to?: DateInput;
+}
+export interface FormatDateRangeOptions {
+    format?: string;
+    preset?: DatePreset;
+    locale?: Locale;
+    separator?: string;
+}
+export interface DateRangeProps extends Omit<DateProps, 'value'>, DateRangeValue {
+    separator?: ReactNode;
+}
+export interface RelativeTimeProps extends SpanProps {
+    value?: DateInput;
+    locale?: Locale;
+    addSuffix?: boolean;
+    includeSeconds?: boolean;
+    emptyLabel?: ReactNode;
+    size?: TextSize;
+    align?: TextProps['align'];
+    weight?: TextProps['weight'];
+    type?: TextProps['type'];
+    formatRelativeTime?: (iso: string) => string;
+    ref?: Ref<HTMLSpanElement>;
+}
+export declare function parseDateInput(value: DateInput): NativeDate | null;
+export declare function formatDateRange({ from, to }: DateRangeValue, { format, preset, locale, separator, }?: FormatDateRangeOptions): string | null;
+export declare function DatePrimitive({ value, format, preset, locale, emptyLabel, size, align, weight, type, className, ref, ...props }: DateProps): import("react").JSX.Element;
+export declare namespace DatePrimitive {
+    var displayName: string;
+}
+export declare function Time({ value, format, preset, locale, emptyLabel, size, align, weight, type, className, ref, ...props }: TimeProps): import("react").JSX.Element;
+export declare function DateTime({ value, format, timeFormat, preset, locale, emptyLabel, size, align, weight, type, className, ref, ...props }: DateTimeProps): import("react").JSX.Element;
+export declare function DateRange({ from, to, format, preset, locale, separator, emptyLabel, size, align, weight, type, className, ref, ...props }: DateRangeProps): import("react").JSX.Element;
+export declare function RelativeTime({ value, locale, addSuffix, includeSeconds, emptyLabel, size, align, weight, type, formatRelativeTime, className, ref, ...props }: RelativeTimeProps): import("react").JSX.Element;
+export {};

package/dist/components/primitives/dimensions.d.ts

@@ -0,0 +1,30 @@
+import { type ComponentPropsWithoutRef, type ReactNode, type Ref } from 'react';
+import { type TextProps } from '../typography';
+import type { TextSize } from '../../lib/ui-provider';
+type SpanProps = Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'color'>;
+type DimensionPart = number | string | null | undefined;
+export interface FormatDimensionsOptions {
+    depth?: DimensionPart;
+    unit?: string;
+    separator?: string;
+    locale?: string;
+    options?: Intl.NumberFormatOptions;
+}
+export interface DimensionsProps extends SpanProps {
+    width?: DimensionPart;
+    height?: DimensionPart;
+    depth?: DimensionPart;
+    unit?: ReactNode;
+    separator?: ReactNode;
+    locale?: string;
+    options?: Intl.NumberFormatOptions;
+    emptyLabel?: ReactNode;
+    size?: TextSize;
+    align?: TextProps['align'];
+    weight?: TextProps['weight'];
+    type?: TextProps['type'];
+    ref?: Ref<HTMLSpanElement>;
+}
+export declare function formatDimensions(width: DimensionPart, height: DimensionPart, { depth, unit, separator, locale, options, }?: FormatDimensionsOptions): string | null;
+export declare function Dimensions({ width, height, depth, unit, separator, locale, options, emptyLabel, size, align, weight, type, className, ref, ...props }: DimensionsProps): import("react").JSX.Element;
+export {};

package/dist/components/primitives/duration.d.ts

@@ -0,0 +1,23 @@
+import { type ComponentPropsWithoutRef, type ReactNode, type Ref } from 'react';
+import { type TextProps } from '../typography';
+import type { TextSize } from '../../lib/ui-provider';
+import { type DurationUnit, type DurationUnitDisplay } from '../../lib/format';
+type SpanProps = Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'color'>;
+export interface DurationProps extends SpanProps {
+    value?: number | null;
+    from?: DurationUnit;
+    locale?: string;
+    maxParts?: number;
+    unitDisplay?: DurationUnitDisplay;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    emptyLabel?: ReactNode;
+    size?: TextSize;
+    align?: TextProps['align'];
+    weight?: TextProps['weight'];
+    type?: TextProps['type'];
+    ref?: Ref<HTMLSpanElement>;
+}
+export declare function Duration({ value, from, locale, maxParts, unitDisplay, minimumFractionDigits, maximumFractionDigits, emptyLabel, size, align, weight, type, className, ref, ...props }: DurationProps): import("react").JSX.Element;
+export { formatDuration } from '../../lib/format';
+export type { DurationUnit, DurationUnitDisplay, FormatDurationOptions } from '../../lib/format';

package/dist/components/primitives/file-size.d.ts

@@ -0,0 +1,23 @@
+import { type ComponentPropsWithoutRef, type ReactNode, type Ref } from 'react';
+import { type TextProps } from '../typography';
+import type { TextSize } from '../../lib/ui-provider';
+type SpanProps = Omit<ComponentPropsWithoutRef<'span'>, 'children' | 'color'>;
+export type FileSizeUnit = 'bytes' | 'kb' | 'mb' | 'gb' | 'tb';
+export interface FileSizeProps extends SpanProps {
+    value?: number | null;
+    from?: FileSizeUnit;
+    locale?: string;
+    emptyLabel?: ReactNode;
+    size?: TextSize;
+    align?: TextProps['align'];
+    weight?: TextProps['weight'];
+    type?: TextProps['type'];
+    ref?: Ref<HTMLSpanElement>;
+}
+export interface FileSizeFormatOptions {
+    from?: FileSizeUnit;
+    locale?: string;
+}
+export declare function formatFileSize(value?: number | null, options?: FileSizeFormatOptions | string): string | null;
+export declare function FileSize({ value, from, locale, emptyLabel, size, align, weight, type, className, ref, ...props }: FileSizeProps): import("react").JSX.Element;
+export {};

package/dist/components/primitives/index.d.ts

@@ -0,0 +1,11 @@
+export { Value, SecondaryValue, MutedValue, MonoValue, EmptyValue, type ValueProps, type EmptyValueProps, type ValueType, } from './value';
+export { Name, formatName, type NameProps, type NameFormatOptions, } from './name';
+export { Initials, type InitialsProps, } from './initials';
+export { formatInitials, type InitialsFormatOptions, type InitialsStrategy, type InitialsMaxCharacters, } from './initials-format';
+export { Link, Email, Phone, Url, type LinkProps, type EmailProps, type PhoneProps, type UrlProps, } from './link';
+export { Money, type MoneyProps, type MoneyValue, type MoneyUnit, type MoneyLayout, type MoneySecondaryEmphasis, } from './money';
+export { DatePrimitive as Date, Time, DateTime, DateRange, RelativeTime, formatDateRange, parseDateInput, type DateProps, type TimeProps, type DateTimeProps, type DateRangeProps, type DateRangeValue, type FormatDateRangeOptions, type RelativeTimeProps, type DatePreset, type DateInput, } from './date';
+export { Number, Percent, type NumberProps, type PercentProps, } from './number';
+export { FileSize, formatFileSize, type FileSizeProps, type FileSizeUnit, } from './file-size';
+export { Duration, formatDuration, type DurationProps, type DurationUnit, type DurationUnitDisplay, type FormatDurationOptions, } from './duration';
+export { Dimensions, formatDimensions, type DimensionsProps, type FormatDimensionsOptions, } from './dimensions';

package/dist/components/primitives/initials-format.d.ts

@@ -0,0 +1,21 @@
+export type InitialsStrategy = 'first-last' | 'first-words';
+export type InitialsMaxCharacters = 1 | 2 | 3;
+export interface InitialsFormatOptions {
+    /** First + last word by default; use first-words to preserve the first N words. */
+    strategy?: InitialsStrategy;
+    /** Maximum visible characters. Defaults to 2. */
+    maxCharacters?: InitialsMaxCharacters;
+    /** Optional BCP-47 locale used for locale-sensitive uppercasing. */
+    locale?: string;
+    /** Returned when no usable letter or number exists. Defaults to an empty string. */
+    fallback?: string;
+}
+/**
+ * Derive short, Unicode-aware initials from a person or resource name.
+ *
+ * `first-last` is the identity default (`Mary Jane Smith` → `MS`). Use
+ * `first-words` for admin surfaces that intentionally use the first
+ * two words (`Mary Jane Smith` → `MJ`). Single-word `first-last` values use
+ * the first N letters (`OpenAI` → `OP`).
+ */
+export declare function formatInitials(value: string | null | undefined, options?: InitialsFormatOptions): string;

package/dist/components/primitives/initials.d.ts

@@ -0,0 +1,16 @@
+import { type ValueProps } from './value';
+import { type InitialsMaxCharacters, type InitialsStrategy } from './initials-format';
+export interface InitialsProps extends Omit<ValueProps, 'children'> {
+    /** Person, organization, or resource name used to derive initials. */
+    value?: string | null;
+    /** First + last word by default; use first-words to preserve the first N words. */
+    strategy?: InitialsStrategy;
+    /** Maximum visible characters. Defaults to 2. */
+    maxCharacters?: InitialsMaxCharacters;
+    /** Optional BCP-47 locale used for locale-sensitive uppercasing. */
+    locale?: string;
+    /** Returned when no usable letter or number exists. Defaults to an empty string. */
+    fallback?: string;
+}
+/** Semantic displayed initials for identities and avatar fallbacks. */
+export declare function Initials({ value, strategy, maxCharacters, locale, fallback, size, className, ref, ...props }: InitialsProps): import("react").JSX.Element;

package/dist/components/primitives/link.d.ts

@@ -0,0 +1,28 @@
+import { type AnchorHTMLAttributes, type ReactNode, type Ref } from 'react';
+export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    children?: ReactNode;
+    emptyLabel?: ReactNode;
+    ref?: Ref<HTMLAnchorElement>;
+}
+export declare function Link({ children, emptyLabel, className, ref, ...props }: LinkProps): import("react").JSX.Element;
+export interface EmailProps extends Omit<LinkProps, 'href' | 'children' | 'ref'> {
+    value?: string | null;
+    display?: ReactNode;
+    subject?: string;
+    body?: string;
+    ref?: Ref<HTMLElement>;
+}
+export declare function Email({ value, display, subject, body, className, emptyLabel, ref, ...props }: EmailProps): import("react").JSX.Element;
+export interface PhoneProps extends Omit<LinkProps, 'href' | 'children' | 'ref'> {
+    value?: string | null;
+    display?: ReactNode;
+    ref?: Ref<HTMLElement>;
+}
+export declare function Phone({ value, display, className, emptyLabel, ref, ...props }: PhoneProps): import("react").JSX.Element;
+export interface UrlProps extends Omit<LinkProps, 'href' | 'children' | 'ref'> {
+    value?: string | null;
+    display?: ReactNode;
+    external?: boolean;
+    ref?: Ref<HTMLElement>;
+}
+export declare function Url({ value, display, external, target, rel, className, emptyLabel, ref, ...props }: UrlProps): import("react").JSX.Element;