themelia-react-ui 2.0.6 → 3.0.0

package/dist/components/blocks/commerce/voucher-entry/voucher-entry.d.ts

@@ -1,5 +1,5 @@
 import { type VoucherEntryProps } from './types';
-export declare function VoucherEntry({ appliedCode, balance, error, loading, onCheck, onRemove, className, strings: stringsProp, }: VoucherEntryProps): import("react").JSX.Element;
+export declare function VoucherEntry({ appliedCode, balance, error, loading, onCheck, onRemove, surface, padding, headerDivider, className, strings: stringsProp, }: VoucherEntryProps): import("react").JSX.Element;
 export declare namespace VoucherEntry {
     var displayName: string;
 }

package/dist/components/blocks/content-block-hooks.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Blocks that used to render through the deprecated `ContentBlock` adapter now
+ * compose `Card` directly. They keep the DOM hooks that adapter painted on the
+ * root and its regions, so consumer selectors written against them still
+ * match. Spread the result last on the `Card`: like the adapter, it owns
+ * `data-component` and `data-slot`.
+ */
+export declare function contentBlockHooks(className?: string, regions?: {
+    header?: string;
+    content?: string;
+    footer?: string;
+}, 
+/** The explicitly requested inset, mirrored on `data-padding` as the adapter did. */
+padding?: string): {
+    readonly 'data-component': "content-block";
+    readonly 'data-slot': "content-block";
+    readonly 'data-padding': string | undefined;
+    readonly className: string;
+    readonly headerClassName: string;
+    readonly contentClassName: string;
+    readonly footerClassName: string;
+};

package/dist/components/blocks/data-display/dense-info-card/dense-info.strings.d.ts

@@ -5,5 +5,9 @@ export interface DenseInfoStrings {
     tasks: string;
     /** Word after the priority value ("High priority"). Additive, so optional for existing dictionaries. */
     priority?: string;
+    /** Writes the task progress. Defaults to `"<completed>/<total> <tasks>"`. */
+    formatTasks?: (completed: number, total: number) => string;
+    /** Writes the priority line. Defaults to the value followed by `priority`. */
+    formatPriority?: (priority: string) => string;
 }
-export declare const defaultDenseInfoStrings: Required<DenseInfoStrings>;
+export declare const defaultDenseInfoStrings: DenseInfoStrings & Required<Pick<DenseInfoStrings, 'priority'>>;

package/dist/components/blocks/data-display/dense-info-card/helpers.d.ts

@@ -1,11 +1,13 @@
 import { type DenseInfoBadgeTone } from './types';
-export declare function ScaleBar({ value, max, label, }: {
+export declare function ScaleBar({ value, max, label, name, }: {
     /** Current amount, used to fill the bar. */
     value: number;
     /** Value representing a full bar. Default: `5`. */
     max?: number;
     /** Caption shown beside the bar. */
     label?: string;
+    /** Accessible name of the meter: what the bar measures. */
+    name?: string;
 }): import("react").JSX.Element;
 export declare function KVRow({ label, value, badge, badgeTone, }: {
     /** Row label. */

package/dist/components/blocks/data-display/dense-info-card/index.d.ts

@@ -4,4 +4,4 @@ export { DenseInfoFinancial } from './partials/dense-info-financial';
 export { DenseInfoProjectCard } from './partials/dense-info-project';
 export { DenseInfoScoreCard } from './partials/dense-info-score';
 export { defaultDenseInfoStrings, type DenseInfoStrings, } from './dense-info.strings';
-export type { DenseInfoBadgeTone, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, } from './types';
+export type { DenseInfoBadgeTone, DenseInfoSurfaceProps, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, } from './types';

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-classification.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoClassificationProps } from '../types';
-export declare function DenseInfoClassification({ title, description, stats, items, totalLabel, totalValue, footerBadges, footerText, actions, className, strings: stringsProp, }: DenseInfoClassificationProps): import("react").JSX.Element;
+export declare function DenseInfoClassification({ title, description, stats, items, totalLabel, totalValue, footerBadges, footerText, actions, surface, padding, headerDivider, className, strings: stringsProp, }: DenseInfoClassificationProps): import("react").JSX.Element;
 export declare namespace DenseInfoClassification {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-dashboard.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoDashboardProps } from '../types';
-export declare function DenseInfoDashboard({ title, description, statusBadges, rows, secondaryRows, scale, footerBadges, footerText, actions, className, }: DenseInfoDashboardProps): import("react").JSX.Element;
+export declare function DenseInfoDashboard({ title, description, statusBadges, rows, secondaryRows, scale, footerBadges, footerText, actions, surface, padding, headerDivider, className, }: DenseInfoDashboardProps): import("react").JSX.Element;
 export declare namespace DenseInfoDashboard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-financial.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoFinancialProps } from '../types';
-export declare function DenseInfoFinancial({ title, description, headerBadges, lineItems, totalLabel, totalAmount, footerBadges, footerText, actions, className, strings: stringsProp, }: DenseInfoFinancialProps): import("react").JSX.Element;
+export declare function DenseInfoFinancial({ title, description, headerBadges, lineItems, totalLabel, totalAmount, footerBadges, footerText, actions, surface, padding, headerDivider, className, strings: stringsProp, }: DenseInfoFinancialProps): import("react").JSX.Element;
 export declare namespace DenseInfoFinancial {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-project.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoProjectCardProps } from '../types';
-export declare function DenseInfoProjectCard({ title, description, statusLabel, statusTone, metaPairs, date, priority, completedTasks, totalTasks, actions, className, strings: stringsProp, }: DenseInfoProjectCardProps): import("react").JSX.Element;
+export declare function DenseInfoProjectCard({ title, description, statusLabel, statusTone, metaPairs, date, priority, completedTasks, totalTasks, actions, surface, padding: paddingProp, headerDivider, className, strings: stringsProp, }: DenseInfoProjectCardProps): import("react").JSX.Element;
 export declare namespace DenseInfoProjectCard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/partials/dense-info-score.d.ts

@@ -1,5 +1,5 @@
 import { type DenseInfoScoreCardProps } from '../types';
-export declare function DenseInfoScoreCard({ title, description, statusBadges, score, scoreLevel, scoreFilled, scoreTotal, rows, footerBadges, actions, className, }: DenseInfoScoreCardProps): import("react").JSX.Element;
+export declare function DenseInfoScoreCard({ title, description, statusBadges, score, scoreLevel, scoreFilled, scoreTotal, rows, footerBadges, actions, surface, padding, headerDivider, className, }: DenseInfoScoreCardProps): import("react").JSX.Element;
 export declare namespace DenseInfoScoreCard {
     var displayName: string;
 }

package/dist/components/blocks/data-display/dense-info-card/types.d.ts

@@ -1,8 +1,15 @@
 import { type ReactNode } from 'react';
 import type { ActionMenuAction } from '../../../base/action-menu';
+import type { CardProps } from '../../../base/cards';
 import type { SemanticTone } from '../../../../lib/component-vocabulary';
 import type { StringsProp } from '../../../../lib/strings';
 import type { DenseInfoStrings } from './dense-info.strings';
+/**
+ * Surface seam shared by the DenseInfo blocks. Unframed and inset-free by
+ * default, so the composing Card owns the frame; set `surface="card"` (or a
+ * `padding`) to let the block own it.
+ */
+export type DenseInfoSurfaceProps = Pick<CardProps, 'surface' | 'padding' | 'headerDivider'>;
 export type DenseInfoBadgeTone = SemanticTone;
 export interface DashboardStatusBadge {
     /** Display label. */
@@ -17,7 +24,7 @@ export interface DashboardKeyValueRow {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoDashboardProps {
+export interface DenseInfoDashboardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -59,7 +66,7 @@ export interface ClassificationRow {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoClassificationProps {
+export interface DenseInfoClassificationProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -96,7 +103,7 @@ export interface FinancialLineItem {
     badge?: string;
     badgeTone?: DenseInfoBadgeTone;
 }
-export interface DenseInfoFinancialProps {
+export interface DenseInfoFinancialProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -126,7 +133,7 @@ export interface ProjectMetaPair {
     /** Display label. */
     label: string;
 }
-export interface DenseInfoProjectCardProps {
+export interface DenseInfoProjectCardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -157,7 +164,7 @@ export interface ScoreKeyValueRow {
     label: string;
     value: string;
 }
-export interface DenseInfoScoreCardProps {
+export interface DenseInfoScoreCardProps extends DenseInfoSurfaceProps {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */

package/dist/components/blocks/data-display/empty-state/empty-state.types.d.ts

@@ -1,4 +1,6 @@
 import type { ReactNode } from 'react';
+import type { EmptySurface } from '../../../base/feedback';
+import type { HeadingTag } from '../../../typography';
 import type { ComponentScale } from '../../../../lib/component-vocabulary';
 import type { StringsProp } from '../../../../lib/strings';
 import type { EmptyStateStrings } from './empty-state.strings';
@@ -36,6 +38,8 @@ export interface EmptyStateProps {
      * ("No products", "No invoices yet"). Falls back to `strings.title`.
      */
     title?: ReactNode;
+    /** Heading level of the title, chosen by the page outline around it. It never changes the size. @default 'h3' */
+    headingTag?: HeadingTag;
     /**
      * Supporting description. Keep it to 1–2 sentences. Falls back to
      * `strings.description`. Pass `false` to hide entirely (when the title
@@ -69,6 +73,8 @@ export interface EmptyStateProps {
     footer?: ReactNode;
     /** Surface inset. Defaults to the provider density scale. Use `none` inside an already padded surface. */
     padding?: EmptyStatePadding;
+    /** `wash` draws the shared quiet well (neutral wash, dashed edge) for a region with no data yet. @default 'plain' */
+    surface?: EmptySurface;
     /**
      * `border` toggles the dashed-border look on/off. Defaults to `false`
      * (no border) — reach for `true` when the empty state replaces a

package/dist/components/blocks/data-display/index.d.ts

@@ -1,6 +1,5 @@
 export type { DenseInfoBadgeTone, DashboardStatusBadge, DashboardKeyValueRow, DenseInfoDashboardProps, ClassificationStat, ClassificationRow, DenseInfoClassificationProps, FinancialHeaderBadge, FinancialLineItem, DenseInfoFinancialProps, ProjectMetaPair, DenseInfoProjectCardProps, ScoreKeyValueRow, DenseInfoScoreCardProps, DenseInfoStrings, } from './dense-info-card';
 export { defaultDenseInfoStrings, DenseInfoDashboard, DenseInfoClassification, DenseInfoFinancial, DenseInfoProjectCard, DenseInfoScoreCard, } from './dense-info-card';
 export * from './empty-state';
-export * from './metadata';
 export { RelationshipCardFrame, type RelationshipCardFrameProps, } from './relationship-card-frame';
 export * from './inline-stat';

package/dist/components/blocks/data-display/relationship-card-frame.d.ts

@@ -22,7 +22,7 @@ export interface RelationshipCardFrameProps extends Omit<HTMLAttributes<HTMLDivE
     alertSlot?: ReactNode;
     /** Label/value facts under the title. */
     metadataSlot?: ReactNode;
-    /** Main control in the header. */
+    /** Main control, rendered in the body under the facts. */
     primaryActionSlot?: ReactNode;
     /** Overflow menu at the end of the header. */
     overflowActionSlot?: ReactNode;

package/dist/components/blocks/onboarding/checklist/checklist.types.d.ts

@@ -9,7 +9,7 @@ export interface OnboardingChecklistStep {
     id: string;
     /** Current status — drives the leading indicator and tone. */
     status: OnboardingStepStatus;
-    /** Step title; renders as a `<Heading tag="h4">`. */
+    /** Step title; renders as semibold `Text` in the step row. */
     title: ReactNode;
     /**
      * Trailing badge — typically a status pill ("Ready", "Required",
@@ -19,7 +19,8 @@ export interface OnboardingChecklistStep {
     badge?: ReactNode;
     /**
      * Body content shown when the step is expanded. This is where
-     * forms / inputs / illustrations live.
+     * forms / inputs / illustrations live. A step without content renders
+     * as a static row with no disclosure.
      */
     content?: ReactNode;
     /** Prevents the step from expanding/collapsing when true. */
@@ -39,7 +40,8 @@ export interface OnboardingChecklistProps {
     steps: OnboardingChecklistStep[];
     /**
      * Initial expanded step ids (uncontrolled). Defaults to opening the
-     * first non-completed step so the user lands on the next thing to do.
+     * first non-completed step that has content, so the user lands on the
+     * next thing to do.
      */
     defaultExpanded?: string[];
     /** Allow multiple steps expanded simultaneously. Defaults to `false`. */

package/dist/components/blocks/planning/task-card.types.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentPropsWithoutRef } from 'react';
+import type { ComponentPropsWithoutRef, MouseEvent } from 'react';
 import type { StackedAvatarUser } from '../../base/avatar';
 import type { BadgeProps } from '../../base/badge';
 import type { CardProps } from '../../base/cards';
@@ -53,8 +53,12 @@ export interface TaskCardProps extends Omit<ComponentPropsWithoutRef<'div'>, 'ch
     onExpandedChange?: (expanded: boolean) => void;
     /** Completion request; update items to accept the change. */
     onItemCompletedChange?: (id: string, completed: boolean) => void;
-    /** Open action supplied by the application. */
-    onOpen?: () => void;
+    /**
+     * Open action supplied by the application. With `href` the action stays a
+     * real link and the handler receives the click: call
+     * `event.preventDefault()` to route in-app.
+     */
+    onOpen?: (event: MouseEvent<HTMLElement>) => void;
     /** Native navigation destination for the Open action. */
     href?: string;
     /** Disables disclosure, completion and the Open action. */

package/dist/components/blocks/timelines/changelog/types.d.ts

@@ -16,12 +16,12 @@ export interface ChangelogEntry {
     author?: string;
 }
 export interface ChangelogTimelineStrings {
-    /** Surface title. */
-    title: string;
     added: string;
     removed: string;
     modified: string;
     fixed: string;
+    /** Writes the author credit after an entry. Defaults to an em dash and the name. */
+    formatAuthor?: (author: string) => string;
 }
 export declare const defaultChangelogTimelineStrings: ChangelogTimelineStrings;
 export interface ChangelogTimelineProps {

package/dist/components/blocks/timelines/index.d.ts

@@ -1,5 +1,5 @@
-export type { StepStatus, StepItem, StepsCardProps, StepsHorizontalProps } from './steps-card';
-export { StepsCard, StepsHorizontal } from './steps-card';
+export type { StepStatus, StepItem, StepsCardProps, StepsHorizontalProps, StepsStrings } from './steps-card';
+export { StepsCard, StepsHorizontal, defaultStepsStrings } from './steps-card';
 export { Timeline, type TimelineProps, type TimelineItem, type TimelineStatus, type TimelineDotSize, } from './shared';
 export { ChangelogTimeline, defaultChangelogTimelineStrings, type ChangelogTimelineProps, type ChangelogTimelineStrings, type ChangelogEntry, type ChangelogEntryKind, } from './changelog';
 export { MilestonesTimeline, defaultMilestonesTimelineStrings, type MilestonesTimelineProps, type MilestonesTimelineStrings, type MilestoneItem, type MilestoneStatus, } from './milestones';

package/dist/components/blocks/timelines/milestones/types.d.ts

@@ -14,13 +14,13 @@ export interface MilestoneItem {
     progress?: number;
 }
 export interface MilestonesTimelineStrings {
-    /** Surface title. */
-    title: string;
     completed: string;
     in_progress: string;
     upcoming: string;
     blocked: string;
     dueOn: string;
+    /** Writes the due date line. Defaults to `dueOn` followed by the date. */
+    formatDueOn?: (date: string) => string;
 }
 export declare const defaultMilestonesTimelineStrings: MilestonesTimelineStrings;
 export interface MilestonesTimelineProps {

package/dist/components/blocks/timelines/shared/timeline.d.ts

@@ -26,6 +26,12 @@ export interface TimelineItem {
     /** Leading glyph. */
     icon?: LucideIcon;
     status?: TimelineStatus;
+    /**
+     * State in words, read out before the title. The dot shows state by colour
+     * and glyph only; the current step is already announced through
+     * `aria-current`, so pass this for the other states.
+     */
+    statusLabel?: ReactNode;
     children?: ReactNode;
 }
 export interface TimelineProps {

package/dist/components/blocks/timelines/steps-card/index.d.ts

@@ -1,2 +1,3 @@
-export type { StepStatus, StepItem, StepsCardProps, StepsHorizontalProps } from './types';
+export type { StepStatus, StepItem, StepsCardProps, StepsHorizontalProps, StepsStrings } from './types';
+export { defaultStepsStrings } from './types';
 export { StepsCard, StepsHorizontal } from './steps-card';

package/dist/components/blocks/timelines/steps-card/steps-card.d.ts

@@ -1,9 +1,9 @@
 import { type StepsCardProps, type StepsHorizontalProps } from './types';
-export declare function StepsCard({ title, description, steps, footerText, className }: StepsCardProps): import("react").JSX.Element;
+export declare function StepsCard({ title, description, steps, footerText, surface, padding, headerDivider, className, strings: stringsProp, }: StepsCardProps): import("react").JSX.Element;
 export declare namespace StepsCard {
     var displayName: string;
 }
-export declare function StepsHorizontal({ title, description, steps, footerText, className }: StepsHorizontalProps): import("react").JSX.Element;
+export declare function StepsHorizontal({ title, description, steps, footerText, className, strings: stringsProp }: StepsHorizontalProps): import("react").JSX.Element;
 export declare namespace StepsHorizontal {
     var displayName: string;
 }

package/dist/components/blocks/timelines/steps-card/types.d.ts

@@ -1,5 +1,7 @@
 import { type ReactNode } from 'react';
 import type { BadgeTone } from '../../../base/badge';
+import type { CardProps } from '../../../base/cards';
+import type { StringsProp } from '../../../../lib/strings';
 export type StepStatus = 'completed' | 'current' | 'upcoming';
 export interface StepItem {
     /** Stable identity for this entry. */
@@ -16,7 +18,13 @@ export interface StepItem {
     badgeTone?: BadgeTone;
     content?: ReactNode;
 }
-export interface StepsCardProps {
+export interface StepsStrings {
+    /** Each step state in words, for assistive technology; the markers show it by colour and glyph. */
+    statusLabels: Record<StepStatus, string>;
+}
+export declare const defaultStepsStrings: StepsStrings;
+/** Unframed by default. Set surface="card" to let this owner frame its heading and body. */
+export interface StepsCardProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider'> {
     /** Surface title. */
     title: string;
     /** Supporting copy shown under the label. */
@@ -25,6 +33,8 @@ export interface StepsCardProps {
     footerText?: ReactNode;
     /** Merged onto the outermost node. */
     className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<StepsStrings>;
 }
 export interface StepsHorizontalProps {
     /** Surface title. */
@@ -35,4 +45,6 @@ export interface StepsHorizontalProps {
     footerText?: ReactNode;
     /** Merged onto the outermost node. */
     className?: string;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<StepsStrings>;
 }

package/dist/components/features/activities/activities.strings.d.ts

@@ -12,6 +12,10 @@ export interface ActivitiesStrings {
     empty: string;
     /** Loading-state copy. */
     loading: string;
+    /** Error-state title. Optional for existing complete string objects. */
+    error?: string;
+    /** Label of the error state's retry control. Optional for existing complete string objects. */
+    retry?: string;
     /** Date-group label for today. */
     today: string;
     /** Date-group label for yesterday. */
@@ -26,13 +30,11 @@ export interface ActivitiesStrings {
     hideChanges: string;
     /** aria-label for the actions menu trigger. */
     actionsLabel: string;
-    /** Generic "more" affordance label. */
-    moreLabel: string;
     /** Map of `source` → display label. */
     sources: Record<string, string>;
     /** Map of `event` → display label. Used as a fallback for headlines. */
     events: Record<string, string>;
 }
-export declare const defaultActivitiesStrings: ActivitiesStrings;
+export declare const defaultActivitiesStrings: ActivitiesStrings & Required<Pick<ActivitiesStrings, 'error' | 'retry'>>;
 /** Replace `{{key}}` tokens with values from `params`. */
 export declare function interpolate(template: string, params: Record<string, string | number>): string;

package/dist/components/features/activities/activities.types.d.ts

@@ -5,7 +5,7 @@
  */
 import type { LucideIcon } from 'lucide-react';
 import type { Locale } from 'date-fns';
-import type { ComponentType, ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { CommentData, CommentSubmitHelpers, CommentFormValues, CommentUser, CommentsAccessors, CommentsConfig, CommentsStrings } from '../comments';
 import type { Mention, MentionsConfig } from '../mentions';
 import type { StringsProp } from '../../../lib/strings';
@@ -208,6 +208,8 @@ export interface ActivityFeedSlots<TData = unknown> {
     empty?: ReactNode;
     /** Replace the loading state. */
     loading?: ReactNode;
+    /** Replace the error state. */
+    error?: ReactNode;
     /** Rendered above the first row (e.g. composer). */
     header?: ReactNode;
     /** Rendered below the last row. */
@@ -223,13 +225,17 @@ export interface ActivityRowClassNames<TData = unknown> {
 }
 /** Accessor functions — consumer maps domain ↔ feature. */
 export interface ActivityFeedAccessors<TData = unknown> {
-    /** Format ISO → relative ("2 hours ago"). Defaults to `date-fns`. */
+    /** Format ISO → relative ("2 hours ago"). Defaults to the provider's formatter, then date-fns with the configured locale. */
     formatRelativeTime?: (iso: string) => string;
     /** Format ISO → absolute. Defaults to date-fns with the configured locale. */
     formatAbsoluteTime?: (iso: string) => string;
     /** Format the date-group label. Defaults to today/yesterday/date-fns. */
     formatDateGroupLabel?: (iso: string | null, strings: ActivitiesStrings) => string;
-    /** Resolve `event` → display label. Defaults to event-config / strings / event. */
+    /**
+     * Resolve `event` → display label, used as the headline of a row that has
+     * neither `headline` nor `segments`. Falls back to `strings.events[event]`,
+     * then the event config's `label`, then the event key.
+     */
     getEventLabel?: (event: string) => string | undefined;
     /** Resolve `source` → display label. Defaults to `strings.sources[source]`. */
     getSourceLabel?: (source: string) => string | undefined;
@@ -274,6 +280,14 @@ export interface ActivityFeedProps<TData = unknown> extends ActivityFeedAccessor
     currentUserId?: string;
     /** Loading flag — switches to `slots.loading`. */
     loading?: boolean;
+    /**
+     * The activity could not be loaded: shows the error state in place of the
+     * rows, keeping `slots.header` and `slots.footer`. An `Error` contributes
+     * its message as the description; a node is shown as the description.
+     */
+    error?: boolean | Error | ReactNode;
+    /** Repeats the failed load; renders the error state's retry control. */
+    onRetry?: () => void;
     /** Mass event configuration. Merged with `defaultActivityEventConfig`. */
     eventConfig?: ActivityEventConfigMap;
     /** String overrides (deep-partial). */
@@ -393,6 +407,8 @@ export interface ActivityLogClassNames<TResource extends string = string> {
     eventContent?: ActivityLogClassNameValue<TResource>;
     eventDetails?: ActivityLogClassNameValue<TResource>;
 }
+/** State regions of `ActivityLog` a consumer can replace. */
+export type ActivityLogSlots = Pick<ActivityFeedSlots, 'empty' | 'loading' | 'error'>;
 export interface ActivityLogProps<TUser extends CommentUser = CommentUser, TMeta = unknown, TResource extends string = string> extends CommentsAccessors {
     /** Feed entries — activities and comments — to render. */
     entries: ReadonlyArray<ActivityLogEntry<TUser, TMeta, TResource>>;
@@ -429,15 +445,16 @@ export interface ActivityLogProps<TUser extends CommentUser = CommentUser, TMeta
     classNames?: ActivityLogClassNames<TResource>;
     /** Comment composer configuration. Omit to render the feed read-only. */
     composer?: ActivityLogComposerConfig<TResource>;
-    /** Drops the card chrome so the feed sits directly on the page. */
-    bare?: boolean;
-    /** Surface title. */
+    /** Shows the loading state in place of the entries; the composer stays. */
+    loading?: boolean;
+    /** Shows the error state in place of the entries; the composer stays. See `ActivityFeedProps.error`. */
+    error?: boolean | Error | ReactNode;
+    /** Repeats the failed load; renders the error state's retry control. */
+    onRetry?: () => void;
+    /** Replaces the default empty, loading or error state. */
+    slots?: ActivityLogSlots;
+    /** Heading above the log. Defaults to `activityStrings.title`; `false` renders the log with no heading, for a log inside a titled Card or section. */
     title?: ReactNode;
-    /** Renders user avatars, letting the consumer supply its own component. */
-    avatarComponent?: ComponentType<{
-        user: TUser | undefined;
-        size: 'sm' | 'md' | 'lg';
-    }>;
     className?: string;
 }
 export type ActivityLogSubmit<TResource extends string = string> = (values: CommentFormValues<TResource>, helpers: CommentSubmitHelpers) => void | Promise<void>;

package/dist/components/features/activities/hooks/use-activity-feed.d.ts

@@ -4,6 +4,12 @@
  * Returns date-grouped activities with stable React keys, plus the expand /
  * collapse map for change-detail rows. Consumers wanting a fully custom UI
  * can call this hook directly and bypass `<ActivityFeed />`.
+ *
+ * The default groups follow the viewer's local day ("Today", "Yesterday", a
+ * long date). On the server and during hydration they follow the UTC day and
+ * name the date, so server HTML never depends on the server's clock or time
+ * zone; the local groups replace them right after hydration. A custom
+ * `formatDateGroupLabel` is called in both passes and owns its own stability.
  */
 import { type Locale } from 'date-fns';
 import type { ActivitiesStrings } from '../activities.strings';

package/dist/components/features/activities/index.d.ts

@@ -3,6 +3,6 @@ export { ActivityLog } from './activity-log';
 export { createActivityEventAdapter, toActivityLogEntry, type ActivityEventAdapterAccessors, } from './activity-event-adapter';
 export { defaultActivitiesStrings, interpolate as interpolateActivityString, type ActivitiesStrings, } from './activities.strings';
 export { defaultActivityEventConfig, defaultEventConfig, resolveEventConfig, } from './activities.config';
-export type { ActivityAction, ActivityActor, ActivityChange, ActivityDensity, ActivityEventConfig, ActivityEventConfigMap, ActivityFeedAccessors, ActivityFeedCallbacks, ActivityFeedProps, ActivityFeedSlots, ActivityHeadlineSegment, ActivityItem, ActivityItemSpacing, ActivityLogActivityEntry, ActivityLogClassNames, ActivityLogCommentEntry, ActivityLogComposerConfig, ActivityLogEntry, ActivityLogEventAction, ActivityLogEventRenderContext, ActivityLogProps, ActivityLogRenderer, ActivityLogSubmit, ActivityRenderRowContext, ActivityResourceConfig, ActivityResourceRef, ActivityResourcesProps, ActivityRowClassNames, ActivityRowClassNameValue, ActivityTone, } from './activities.types';
+export type { ActivityAction, ActivityActor, ActivityChange, ActivityDensity, ActivityEventConfig, ActivityEventConfigMap, ActivityFeedAccessors, ActivityFeedCallbacks, ActivityFeedProps, ActivityFeedSlots, ActivityLogSlots, ActivityHeadlineSegment, ActivityItem, ActivityItemSpacing, ActivityLogActivityEntry, ActivityLogClassNames, ActivityLogCommentEntry, ActivityLogComposerConfig, ActivityLogEntry, ActivityLogEventAction, ActivityLogEventRenderContext, ActivityLogProps, ActivityLogRenderer, ActivityLogSubmit, ActivityRenderRowContext, ActivityResourceConfig, ActivityResourceRef, ActivityResourcesProps, ActivityRowClassNames, ActivityRowClassNameValue, ActivityTone, } from './activities.types';
 export { ActivityActionsMenu, ActivityChanges, ActivityDateLabel, ActivityEmptyState, ActivityHeadline, ActivityMarker, ActivityResourceTag, ActivityRow, type ActivityActionsMenuProps, type ActivityChangesProps, type ActivityDateLabelProps, type ActivityEmptyStateProps, type ActivityHeadlineProps, type ActivityMarkerProps, type ActivityResourceTagProps, type ActivityRowProps, } from './partials';
 export { useActivityFeed, useActivityResources, type ActivityDateGroup, type ActivityKeyedItem, type ActivityResourceRegistry, type UseActivityFeedOptions, type UseActivityFeedReturn, type UseActivityResourcesOptions, type UseActivityResourcesReturn, } from './hooks';

package/dist/components/features/activities/partials/activity-headline.d.ts

@@ -16,5 +16,10 @@ export interface ActivityHeadlineProps<TData = unknown> {
     activity: ActivityItem<TData>) => void;
     /** Live registry lookup for resource segments. */
     getResourceConfig?: (ref: ActivityResourceRef) => ActivityResourceConfig | undefined;
+    /**
+     * Resolved label of the activity's event, shown when the activity has
+     * neither `headline` nor `segments`. Defaults to the event key.
+     */
+    eventLabel?: string;
 }
 export declare function ActivityHeadline<TData = unknown>(props: ActivityHeadlineProps<TData>): import("react").JSX.Element;

package/dist/components/features/activities/partials/activity-row.d.ts

@@ -1,5 +1,7 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
+import { type StringsProp } from '../../../../lib/strings';
 import type { ActivityAction, ActivityActor, ActivityDensity, ActivityEventConfig, ActivityItemSpacing, ActivityItem, ActivityResourceConfig, ActivityResourceRef, ActivityTone } from '../activities.types';
+import { type ActivitiesStrings } from '../activities.strings';
 export interface ActivityRowProps<TData = unknown> {
     /** The feed entry this row renders. */
     activity: ActivityItem<TData>;
@@ -24,20 +26,17 @@ export interface ActivityRowProps<TData = unknown> {
     absoluteTime: string | null;
     /** Where the activity originated — an app, integration, or API. */
     sourceLabel: string | null;
-    /** Copy substituted for the current user's own name. */
-    youLabel: string;
-    /** Control that reveals the change list. */
-    showChangesLabel: string;
-    /** Control that collapses the change list. */
-    hideChangesLabel: string;
     /**
-     * Copy for remaining metadata in the former collapsed preview.
-     * @deprecated Collapsed rows no longer preview metadata; the full list
-     * appears behind the details disclosure. Accepted for compatibility.
+     * Resolved label of the activity's event, shown as the headline when the
+     * activity has neither `headline` nor `segments`. Defaults to the event key.
      */
-    moreLabel: string;
-    /** Accessible name for the row's overflow trigger. */
-    actionsLabel: string;
+    eventLabel?: string;
+    /**
+     * Overrides the row's own copy: `you` (the current user's name),
+     * `showChanges` and `hideChanges` (the details toggle) and `actionsLabel`
+     * (the overflow menu). The feed passes its resolved strings.
+     */
+    strings?: StringsProp<ActivitiesStrings>;
     /** Id of the viewing user, used to say "you" instead of their name. */
     currentUserId?: string;
     /** Overflow menu for the surface as a whole. */

package/dist/components/features/activities/partials/row-layers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Layering inside an activity row whose primary action is a stretched button
+ * (`activity-row--open`, `absolute inset-0 z-0`). A nested control sits above
+ * that button so it takes its own presses; plain copy stays below it, so a
+ * press on the copy opens the row. Harmless in a row without the button.
+ */
+export declare const nestedControlClassName = "relative z-10";

package/dist/components/features/activities/relative-time.d.ts

@@ -0,0 +1,18 @@
+import { type Locale } from 'date-fns';
+/**
+ * The default relative time for activity rows ("2 hours ago"), shared by
+ * `ActivityFeed` and `ActivityLog`. An explicit `formatRelativeTime`, then the
+ * provider's, win over it; an unreadable timestamp is shown as written.
+ */
+export declare function formatActivityRelativeTime(iso: string, locale?: Locale): string;
+/**
+ * Whether this render may read the local clock and time zone. `false` on the
+ * server and while its HTML is being hydrated, where the browser must repeat
+ * the server's output exactly; `true` from the first render of a client-only
+ * mount, and from the render React schedules right after hydration.
+ */
+export declare function useLocalClock(): boolean;
+/** A date label that reads the same on a server and in any browser. */
+export declare function formatActivityUtcDate(iso: string, locale?: Locale): string;
+/** A date and time that read the same on a server and in any browser. */
+export declare function formatActivityUtcDateTime(iso: string, locale?: Locale): string;

package/dist/components/features/ai-chat/ai-chat.d.ts

@@ -34,11 +34,15 @@ export interface AiChatProps<TSuggestionData = unknown> {
     onInputChange: (value: string) => void;
     /** Fired on submit (Enter or send button). */
     onSubmit?: (values: AiChatSubmitValues) => void;
-    /** Fired when the user clicks the stop button while `streaming`. */
+    /** Fired when the user clicks the stop button while `streaming`. Without it no stop button is offered. */
     onStop?: () => void;
     /** Streaming flag — controls submit/stop UI in the prompt input. */
     streaming?: boolean;
-    /** Disable composer entirely. */
+    /**
+     * Disable the composer entirely: the prompt, attachments, suggestion chips
+     * and queue cancellation. Suggestions and the queue stay available while
+     * `streaming`, so a pick can be queued behind the running response.
+     */
     disabled?: boolean;
     /** Currently staged attachments. */
     attachments?: ReadonlyArray<AiChatAttachment>;