themelia-react-ui 2.0.5 → 3.0.0

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

@@ -1,15 +1,18 @@
 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';
 /**
- * Vertical breathing room.
+ * Surface inset.
  *
+ * `none` — flush inside a parent that already owns the inset.
  * `sm` — compact cards, table cells, and side panels.
  * `md` — normal table, list, and card empty states.
  * `lg` — large page-level empty states.
  */
-export type EmptyStatePadding = ComponentScale;
+export type EmptyStatePadding = ComponentScale | 'none';
 /**
  * How the `media` slot renders.
  *
@@ -35,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
@@ -66,8 +71,10 @@ export interface EmptyStateProps {
      * keyboard hints, etc.
      */
     footer?: ReactNode;
-    /** Vertical breathing. Defaults to the provider density scale; tune values through CSS variables. */
+    /** 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';
@@ -61,26 +61,27 @@ export interface ActivityResourceConfig {
     /** Free-form note exposed via tooltip. */
     note?: string;
 }
-/** A single piece of the headline — blocks inline by the renderer. */
-export type ActivityHeadlineSegment = {
-    type: 'text';
+type ActivityHeadlineText = {
     text: string;
-} | {
+    /** React content rendered in place of the text fallback. */
+    content?: ReactNode;
+};
+/** A single inline piece of the headline. */
+export type ActivityHeadlineSegment = ({
+    type: 'text';
+} & ActivityHeadlineText) | {
     type: 'actor';
     text: string;
     actorId?: string;
     href?: string;
-} | {
+} | ({
     type: 'field';
-    text: string;
-} | {
+} & ActivityHeadlineText) | ({
     type: 'value';
-    text: string;
-} | {
+} & ActivityHeadlineText) | ({
     type: 'status';
-    text: string;
     tone?: ActivityTone;
-} | {
+} & ActivityHeadlineText) | {
     type: 'resource';
     text?: string;
     resource: ActivityResourceRef;
@@ -106,6 +107,8 @@ export interface ActivityItem<TData = unknown> {
     event: string;
     /** Optional source bucket — drives the source-badge label. */
     source?: string;
+    /** React content for the source badge. Takes precedence over the source label. */
+    sourceContent?: ReactNode;
     actor?: ActivityActor;
     /** Pre-built segments — preferred over `headline`. */
     segments?: readonly ActivityHeadlineSegment[];
@@ -205,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. */
@@ -220,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;
@@ -271,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). */
@@ -325,8 +342,11 @@ export interface ActivityLogActivityEntry<TResource extends string = string> {
     /** The action this surface performs. */
     action?: string;
     target?: ReactNode;
+    /** Status badge content. Takes precedence over the target value. */
+    status?: ReactNode;
     /** Display label. */
     label?: ReactNode;
+    /** Fallback headline when no action or target is supplied. Accepts inline React content. */
     headline?: ReactNode;
     /** Supporting copy shown under the label. */
     description?: ReactNode;
@@ -387,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>>;
@@ -423,15 +445,17 @@ 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>;
+export {};

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/hooks/use-activity-resources.d.ts

@@ -1,6 +1,7 @@
 import type { ActivityResourceConfig, ActivityResourceRef } from '../activities.types';
 export type ActivityResourceRegistry = Readonly<Record<string, ActivityResourceConfig>>;
 export interface UseActivityResourcesOptions {
+    /** Registry seed. Equivalent resource values preserve local edits. */
     resources?: ActivityResourceRegistry;
     onResourcesChange?: (registry: ActivityResourceRegistry) => void;
 }
@@ -16,7 +17,7 @@ export interface UseActivityResourcesReturn {
     remove: (key: string) => void;
     /** Replace the entire registry. */
     setAll: (registry: ActivityResourceRegistry) => void;
-    /** Reset to the original `resources` prop (or empty if none). */
+    /** Reset to the latest resource seed. */
     reset: () => void;
 }
 export declare function useActivityResources({ resources, onResourcesChange, }?: UseActivityResourcesOptions): UseActivityResourcesReturn;

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>;

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

@@ -4,6 +4,18 @@
  * Consumers override via the `strings` prop on the relevant component; values
  * are deep-merged over the defaults so partial overrides are safe.
  */
+import type { StringsProp } from '../../../lib/strings';
+import type { AiAgentStrings } from '../../blocks/ai/ai-agent';
+import type { AiArtifactStrings } from '../../blocks/ai/ai-artifact';
+import type { AiAttachmentStrings } from '../../blocks/ai/ai-attachment';
+import type { AiChainOfThoughtStrings } from '../../blocks/ai/ai-chain-of-thought';
+import type { AiCodeBlockStrings } from '../../blocks/ai/ai-code-block';
+import type { AiConfirmationStrings } from '../../blocks/ai/ai-confirmation';
+import type { AiMessageBubbleStrings } from '../../blocks/ai/ai-message-bubble';
+import type { AiReasoningStrings } from '../../blocks/ai/ai-reasoning';
+import type { AiSourcesStrings } from '../../blocks/ai/ai-sources';
+import type { AiTaskStrings } from '../../blocks/ai/ai-task';
+import type { AiToolCallStrings } from '../../blocks/ai/ai-tool-call';
 export interface AiChatPromptInputStrings {
     /** Placeholder copy for the textarea. */
     placeholder: string;
@@ -13,10 +25,10 @@ export interface AiChatPromptInputStrings {
     submitAria: string;
     /** Aria label for the stop button (replaces submit while streaming). */
     stopAria: string;
-    /** Aria label for the model picker button (when `modelPicker` is provided). */
-    modelPickerAria: string;
     /** Hint shown under the input. Supports `{{key}}` for the submit shortcut. */
     hint: string;
+    /** Copy for staged attachment chips: remove, upload progress and failure. Omitted keys keep the chip's defaults. */
+    attachment?: StringsProp<AiAttachmentStrings>;
 }
 export declare const defaultAiChatPromptInputStrings: AiChatPromptInputStrings;
 export interface AiChatConversationStrings {
@@ -38,8 +50,33 @@ export interface AiChatSuggestionsStrings {
     header: string;
 }
 export declare const defaultAiChatSuggestionsStrings: AiChatSuggestionsStrings;
+/**
+ * Message copy. `pending` is the placeholder shown before any part arrives;
+ * the optional groups localize the parts a message renders, and each is
+ * forwarded to its `blocks/ai` surface, whose own defaults fill omitted keys.
+ */
 export interface AiChatMessageStrings {
     pending: string;
+    /** The bubble's copy, copied, regenerate and loading labels. */
+    bubble?: StringsProp<AiMessageBubbleStrings>;
+    /** Tool-call status and detail labels. */
+    toolCall?: StringsProp<AiToolCallStrings>;
+    /** Approve, reject and outcome labels of a confirmation part. */
+    confirmation?: StringsProp<AiConfirmationStrings>;
+    /** Reasoning header and disclosure labels. */
+    reasoning?: StringsProp<AiReasoningStrings>;
+    /** Sources title and visit labels. */
+    sources?: StringsProp<AiSourcesStrings>;
+    /** Code block copy labels. */
+    codeBlock?: StringsProp<AiCodeBlockStrings>;
+    /** Artifact open, copy and download labels. */
+    artifact?: StringsProp<AiArtifactStrings>;
+    /** Task status and subtask disclosure labels. */
+    task?: StringsProp<AiTaskStrings>;
+    /** Attachment chips inside a message: open and failure labels. */
+    attachment?: StringsProp<AiAttachmentStrings>;
+    /** Chain-of-thought title and streaming hint. */
+    chainOfThought?: StringsProp<AiChainOfThoughtStrings>;
 }
 export declare const defaultAiChatMessageStrings: AiChatMessageStrings;
 export interface AiChatStrings {
@@ -48,6 +85,8 @@ export interface AiChatStrings {
     queue: AiChatQueueStrings;
     suggestions: AiChatSuggestionsStrings;
     message: AiChatMessageStrings;
+    /** Status labels of the agent shown in the header. Omitted keys keep the agent's defaults. */
+    agent?: StringsProp<AiAgentStrings>;
     emptyTitle: string;
     emptyDescription: string;
     /** Screen-reader announcement emitted while the composer is disabled. */

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

@@ -91,6 +91,12 @@ export type AiChatMessagePart = {
     details?: ReactNode;
     onApprove?: () => void;
     onReject?: () => void;
+    /** Names this decision's approve action, such as "Delete rows". */
+    approveLabel?: ReactNode;
+    /** Names this decision's reject action. */
+    rejectLabel?: ReactNode;
+    /** Leading glyph that identifies the kind of decision. */
+    icon?: LucideIcon;
 } | {
     type: 'custom';
     render: () => ReactNode;

package/dist/components/features/ai-chat/hooks/use-ai-chat-scroll.d.ts

@@ -1,7 +1,7 @@
 export interface UseAiChatScrollOptions {
     /** Distance (px) from bottom counted as "at bottom". */
     threshold?: number;
-    /** Re-evaluate on these dependencies (typically the message count). */
+    /** Re-evaluate when content changes, including updates to existing messages. */
     dependency?: unknown;
     /** Disable auto-scroll-on-update behaviour. */
     disableAutoScroll?: boolean;