themelia-react-ui 2.0.5 → 3.0.0

package/dist/components/base/value-inputs/slider.d.ts

@@ -42,9 +42,12 @@ export interface SliderProps {
     disabled?: boolean;
     /** Error state for styling (passed from FormField) */
     invalid?: boolean;
-    /** Event-style change handler for react-hook-form compatibility */
+    /**
+     * Event-shaped channel for form libraries (`{ target: { value } }`), as on
+     * the numeric inputs. Both callbacks run on every change.
+     */
     onChange?: (event: SliderImitationEvent) => void;
-    /** Raw value change handler (alternative to onChange) */
+    /** The canonical value callback, as on every other control: the number itself. */
     onValueChange?: (value: number) => void;
     /** Fires on pointer up / keyboard commit */
     onValueCommitted?: (value: number) => void;

package/dist/components/blocks/admin/action-surfaces/index.d.ts

@@ -1,9 +1,11 @@
 import { type ReactNode } from 'react';
 import { type LucideIcon } from 'lucide-react';
+import { type CardProps } from '../../../base/cards';
 import { type StringsProp } from '../../../../lib/strings';
-import type { CardSurface, ComponentScale } from '../../../../lib/component-vocabulary';
-import { type ApiKeyListItem } from '../api-key-list';
-type ActionSurfacePadding = ComponentScale;
+import type { CardSurface } from '../../../../lib/component-vocabulary';
+import { type ApiKeyListItem, type ApiKeyListStrings } from '../api-key-list';
+/** Card's inset scale, including `none` inside an existing boundary. */
+type ActionSurfacePadding = NonNullable<CardProps['padding']>;
 type ActionSurfaceSurface = CardSurface;
 export interface SensitiveActionCardProps {
     /** Surface title. */
@@ -86,6 +88,11 @@ export interface ApiTokenManagerStrings {
     createdTitle: string;
     createdDescription: string;
 }
+/**
+ * Copy for the embedded token list, in the manager's own terms: tokens are
+ * revoked, not deleted. Override any key through `listStrings`.
+ */
+export declare const defaultApiTokenListStrings: ApiKeyListStrings;
 export declare const defaultApiTokenManagerStrings: ApiTokenManagerStrings;
 export interface ApiTokenManagerProps {
     /** API access credentials to display and manage. */
@@ -119,8 +126,14 @@ export interface ApiTokenManagerProps {
     className?: string;
     /** Overrides this surface's own copy. */
     strings?: StringsProp<ApiTokenManagerStrings>;
+    /** Overrides the embedded token list's copy (section title, row menu, copy feedback, empty line). */
+    listStrings?: StringsProp<ApiKeyListStrings>;
+    /** Outer chrome. Omit it to stay card-free. */
+    surface?: CardSurface;
+    /** Surface inset. Defaults to `none` when unframed and `md` on a framed surface. */
+    padding?: CardProps['padding'];
 }
-export declare function ApiTokenManager({ tokens, abilities, createdToken, name, defaultName, onNameChange, selectedAbilities, defaultSelectedAbilities, onSelectedAbilitiesChange, onCreateToken, onRevokeToken, onRevokeAllTokens, onAfterMutate, onError, creating: creatingProp, revokingAll: revokingAllProp, disabled, className, strings: stringsProp, }: ApiTokenManagerProps): import("react").JSX.Element;
+export declare function ApiTokenManager({ tokens, abilities, createdToken, name, defaultName, onNameChange, selectedAbilities, defaultSelectedAbilities, onSelectedAbilitiesChange, onCreateToken, onRevokeToken, onRevokeAllTokens, onAfterMutate, onError, creating: creatingProp, revokingAll: revokingAllProp, disabled, className, strings: stringsProp, listStrings: listStringsProp, surface, padding, }: ApiTokenManagerProps): import("react").JSX.Element;
 export declare namespace ApiTokenManager {
     var displayName: string;
 }

package/dist/components/blocks/admin/api-key-list/api-key-list.types.d.ts

@@ -25,7 +25,7 @@ export interface ApiKeyListItem {
     displayValue?: string;
     /** Optional per-item leading icon. Rows render without one by default. */
     icon?: ReactNode;
-    /** Disable the per-item dropdown when true. */
+    /** Disables this key's menu when true. */
     disabled?: boolean;
 }
 export interface ApiKeyListProps {
@@ -45,10 +45,16 @@ export interface ApiKeyListProps {
     onDelete?: (id: string, item: ApiKeyListItem) => void;
     /**
      * Per-item copy callback fired AFTER the value has been written to the
-     * clipboard — useful for analytics. The library handles the actual
-     * write via `base/copyable`.
+     * clipboard — useful for analytics. The list performs the write itself.
      */
     onCopy?: (id: string, item: ApiKeyListItem) => void;
+    /** Disables the add action and every row menu, for a list whose owner is busy or read-only. */
+    disabled?: boolean;
+    /**
+     * Ids of rows with a request in flight (a revoke, for example). Each is
+     * marked busy and its menu is disabled until the id leaves the list.
+     */
+    pendingIds?: readonly string[];
     /** Optional title override (defaults to `strings.title`). */
     title?: ReactNode;
     /** Merged onto the outermost node. */

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

@@ -1,4 +1,4 @@
 export type { Permission, PermissionSection, RolePermissionProps } from './role-permission';
 export { RolePermission } from './role-permission';
 export { ApiKeyList, defaultApiKeyListStrings, type ApiKeyListItem, type ApiKeyListProps, type ApiKeyListStrings, } from './api-key-list';
-export { ApiTokenManager, CopyableSecretAlert, SensitiveActionCard, defaultApiTokenManagerStrings, defaultCopyableSecretAlertStrings, type ApiTokenAbility, type ApiTokenCreateValues, type ApiTokenCreatedToken, type ApiTokenManagerProps, type ApiTokenManagerStrings, type CopyableSecretAlertProps, type CopyableSecretAlertStrings, type SensitiveActionCardProps, } from './action-surfaces';
+export { ApiTokenManager, CopyableSecretAlert, SensitiveActionCard, defaultApiTokenListStrings, defaultApiTokenManagerStrings, defaultCopyableSecretAlertStrings, type ApiTokenAbility, type ApiTokenCreateValues, type ApiTokenCreatedToken, type ApiTokenManagerProps, type ApiTokenManagerStrings, type CopyableSecretAlertProps, type CopyableSecretAlertStrings, type SensitiveActionCardProps, } from './action-surfaces';

package/dist/components/blocks/ai/ai-artifact/ai-artifact.d.ts

@@ -1,5 +1,5 @@
 import { type AiArtifactProps } from './types';
-export declare function AiArtifact({ title, subtitle, icon, copyText, children, collapsed, onOpen, actions, onDownload, onCopyError, className, strings: stringsProp, }: AiArtifactProps): import("react").JSX.Element;
+export declare function AiArtifact({ title, subtitle, icon, copyText, children, collapsed, onOpen, actions, onDownload, onCopyError, surface, className, strings: stringsProp, }: AiArtifactProps): import("react").JSX.Element;
 export declare namespace AiArtifact {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-artifact/types.d.ts

@@ -1,5 +1,6 @@
 import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 import type { StringsProp } from '../../../../lib/strings';
 export interface AiArtifactStrings {
     openAria: string;
@@ -9,7 +10,6 @@ export interface AiArtifactStrings {
     /** Failure feedback, additive for existing string dictionaries. */
     copyError?: string;
     downloadAria: string;
-    expandAria: string;
 }
 export declare const defaultAiArtifactStrings: AiArtifactStrings;
 export interface AiArtifactAction {
@@ -33,17 +33,22 @@ export interface AiArtifactProps {
     copyText?: string;
     /** Body content — preview, code, sandbox iframe, etc. */
     children?: ReactNode;
-    /** Hide the body and render the artifact as a clickable preview-only chip. */
+    /** Hide the body and render the header alone, as a compact preview chip. */
     collapsed?: boolean;
-    /** Click handler for the whole header (e.g. open in side panel). */
+    /** Adds an open action to the header (e.g. open in a side panel). */
     onOpen?: () => void;
     /** Custom actions in the header. */
     actions?: ReadonlyArray<AiArtifactAction>;
     /** Provide a download handler — adds a download button. */
     onDownload?: () => void;
-    /** Merged onto the outermost node. */
     /** Called when the clipboard is unavailable or the write fails. */
     onCopyError?: (error: unknown) => void;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
+    /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */
     strings?: StringsProp<AiArtifactStrings>;

package/dist/components/blocks/ai/ai-chain-of-thought/ai-chain-of-thought.d.ts

@@ -1,5 +1,5 @@
 import { type AiChainOfThoughtProps } from './types';
-export declare function AiChainOfThought({ steps, hideHeader, streaming, className, strings: stringsProp, }: AiChainOfThoughtProps): import("react").JSX.Element;
+export declare function AiChainOfThought({ steps, hideHeader, streaming, surface, className, strings: stringsProp, }: AiChainOfThoughtProps): import("react").JSX.Element;
 export declare namespace AiChainOfThought {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-chain-of-thought/types.d.ts

@@ -1,6 +1,7 @@
 import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export type AiChainStepStatus = 'pending' | 'active' | 'completed' | 'failed';
 export interface AiChainStep {
     /** Stable identity for this entry. */
@@ -20,8 +21,12 @@ export interface AiChainOfThoughtStrings {
     /** Surface title. */
     title: string;
     streamingHint: string;
+    /** Each step status in words, for assistive technology; the markers show it by colour and glyph. */
+    statusLabels?: Partial<Record<AiChainStepStatus, string>>;
 }
-export declare const defaultAiChainOfThoughtStrings: AiChainOfThoughtStrings;
+export declare const defaultAiChainOfThoughtStrings: AiChainOfThoughtStrings & {
+    statusLabels: Record<AiChainStepStatus, string>;
+};
 export interface AiChainOfThoughtProps {
     /** Step list — order is significant. */
     steps: ReadonlyArray<AiChainStep>;
@@ -29,6 +34,11 @@ export interface AiChainOfThoughtProps {
     hideHeader?: boolean;
     /** Show the streaming hint under the header. */
     streaming?: boolean;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-citation/ai-citation.d.ts

@@ -1,5 +1,5 @@
 import { type AiCitationProps } from './types';
-export declare function AiCitation({ sources, expanded: expandedProp, defaultExpanded, onExpandedChange, maxCollapsedRows, className, strings: stringsProp, }: AiCitationProps): import("react").JSX.Element;
+export declare function AiCitation({ sources, expanded: expandedProp, defaultExpanded, onExpandedChange, maxCollapsedRows, surface, className, strings: stringsProp, }: AiCitationProps): import("react").JSX.Element;
 export declare namespace AiCitation {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-citation/types.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export interface AiCitationSource {
     /** Stable identity for this entry. */
     id: string;
@@ -16,7 +17,9 @@ export interface AiCitationStrings {
     title: string;
     sourceCount: (n: number) => string;
     hiddenCount: (n: number) => string;
+    /** Supplied overrides describe how to open the source list. */
     expand: string;
+    /** Supplied overrides describe how to close the source list. */
     collapse: string;
     visit: string;
     relevance: string;
@@ -31,6 +34,11 @@ export interface AiCitationProps {
     /** Fired whenever the disclosure state changes. */
     onExpandedChange?: (expanded: boolean) => void;
     maxCollapsedRows?: number;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-confirmation/ai-confirmation.d.ts

@@ -1,5 +1,5 @@
 import { type AiConfirmationProps } from './types';
-export declare function AiConfirmation({ title, description, icon, tone, status, onApprove, onReject, approveLabel, rejectLabel, details, className, strings: stringsProp, }: AiConfirmationProps): import("react").JSX.Element;
+export declare function AiConfirmation({ title, description, icon, tone, status, onApprove, onReject, approveLabel, rejectLabel, details, pending, surface, className, strings: stringsProp, }: AiConfirmationProps): import("react").JSX.Element;
 export declare namespace AiConfirmation {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-confirmation/types.d.ts

@@ -2,6 +2,7 @@ import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 import type { SemanticTone } from '../../../../lib/component-vocabulary';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export type AiConfirmationTone = Extract<SemanticTone, 'neutral' | 'destructive' | 'warning' | 'info' | 'primary'>;
 export interface AiConfirmationStrings {
     approve: string;
@@ -23,16 +24,31 @@ export interface AiConfirmationProps {
     tone?: AiConfirmationTone;
     /** Current status — when set, the action row is replaced with a result pill. */
     status?: AiConfirmationStatus;
-    /** Approve callback. */
-    onApprove?: () => void;
-    /** Reject callback. */
-    onReject?: () => void;
+    /**
+     * Approve callback. Return a promise for a side-effecting action: the
+     * approve button shows its loading state and both commands are held until
+     * it settles, so the action cannot run twice.
+     */
+    onApprove?: () => void | Promise<void>;
+    /** Reject callback. A returned promise holds both commands the same way. */
+    onReject?: () => void | Promise<void>;
+    /**
+     * Marks a command as in flight for a request the app tracks itself (a
+     * handler that returns nothing): that button shows its loading state and
+     * both are held. Handlers that return a promise need no prop.
+     */
+    pending?: 'approve' | 'reject';
     /** Override the approve button label. */
     approveLabel?: ReactNode;
     /** Override the reject button label. */
     rejectLabel?: ReactNode;
-    /** Render a "details" expandable area. */
+    /** Extra detail under the description (a diff, a command, affected records). Always shown. */
     details?: ReactNode;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-feedback/types.d.ts

@@ -13,8 +13,13 @@ export interface AiFeedbackProps {
     /** Current value. Controlled. */
     value?: AiFeedbackVote;
     onVote?: (vote: AiFeedbackVote) => void;
-    /** Fired when a comment is submitted. */
-    onSubmitComment?: (comment: string, vote: AiFeedbackVote) => void;
+    /**
+     * Fired when a comment is submitted. Return a promise for a request that
+     * can fail: the comment stays in the field and the button shows its
+     * loading state until it settles, and a rejection keeps the text for a
+     * retry. A synchronous handler clears the field at once.
+     */
+    onSubmitComment?: (comment: string, vote: AiFeedbackVote) => void | Promise<void>;
     allowComment?: boolean;
     submitted?: boolean;
     /** Merged onto the outermost node. */

package/dist/components/blocks/ai/ai-inline-citation/types.d.ts

@@ -1,3 +1,4 @@
+import type { MouseEvent } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
 export interface AiInlineCitationStrings {
     /** Tooltip prefix when only a number is rendered. */
@@ -11,10 +12,15 @@ export interface AiInlineCitationProps {
     index: number;
     /** Title of the cited source — used in the tooltip / aria-label. */
     title?: string;
-    /** Optional URL — when provided, the pill renders as a link. */
+    /** Optional URL — when provided, the pill renders as a link that opens in a new tab. */
     url?: string;
-    /** Click handler — preferred over `url` for SPA / virtual link routing. */
-    onSelect?: () => void;
+    /**
+     * Click handler. Alone, the pill renders as a button. Together with `url`
+     * the pill stays a real link (middle-click and open-in-new-tab keep working)
+     * and the handler receives the click first: call `event.preventDefault()`
+     * to route in-app instead of following the link.
+     */
+    onSelect?: (event: MouseEvent<HTMLElement>) => void;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-package-info/ai-package-info.d.ts

@@ -1,5 +1,5 @@
 import { type AiPackageInfoProps } from './types';
-export declare function AiPackageInfo({ name, version, description, license, publishedAt, homepage, repository, weeklyDownloads, keywords, onSelect, className, strings: stringsProp, }: AiPackageInfoProps): import("react").JSX.Element;
+export declare function AiPackageInfo({ name, version, description, license, publishedAt, homepage, repository, weeklyDownloads, keywords, onSelect, surface, className, strings: stringsProp, }: AiPackageInfoProps): import("react").JSX.Element;
 export declare namespace AiPackageInfo {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-package-info/types.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export interface AiPackageInfoStrings {
     versionLabel: string;
     licenseLabel: string;
@@ -32,6 +33,11 @@ export interface AiPackageInfoProps {
     keywords?: ReadonlyArray<string>;
     /** Click handler for the whole card. */
     onSelect?: () => void;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-reasoning/types.d.ts

@@ -7,7 +7,9 @@ export interface AiReasoningStrings {
     thoughtFor: string;
     /** Header label when no duration is available. */
     thoughtDone: string;
+    /** Supplied overrides describe how to open the reasoning trace. */
     expandAria: string;
+    /** Supplied overrides describe how to close the reasoning trace. */
     collapseAria: string;
 }
 export declare const defaultAiReasoningStrings: AiReasoningStrings;

package/dist/components/blocks/ai/ai-sources/ai-sources.d.ts

@@ -1,5 +1,5 @@
 import { type AiSourcesProps } from './types';
-export declare function AiSources({ sources, variant, maxAvatars, expanded: expandedProp, defaultExpanded, onExpandedChange, onSelect, className, strings: stringsProp, }: AiSourcesProps): import("react").JSX.Element;
+export declare function AiSources({ sources, variant, maxAvatars, expanded: expandedProp, defaultExpanded, onExpandedChange, onSelect, surface, className, strings: stringsProp, }: AiSourcesProps): import("react").JSX.Element;
 export declare namespace AiSources {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-sources/types.d.ts

@@ -1,5 +1,6 @@
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export interface AiSourceItem {
     /** Stable identity for this entry. */
     id: string;
@@ -14,9 +15,11 @@ export interface AiSourceItem {
     snippet?: ReactNode;
 }
 export interface AiSourcesStrings {
-    /** Header title — `{{count}}` placeholder for the source count. */
-    title: string;
+    /** Writes the header title for a source count, so a translation owns its plural forms. */
+    formatTitle: (count: number) => string;
+    /** Supplied overrides describe how to open the source list. */
     expand: string;
+    /** Supplied overrides describe how to close the source list. */
     collapse: string;
     visit: string;
 }
@@ -37,6 +40,11 @@ export interface AiSourcesProps {
     onExpandedChange?: (expanded: boolean) => void;
     /** Click handler — preferred over `url` for SPA routing. */
     onSelect?: (source: AiSourceItem, index: number) => void;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-task/ai-task.d.ts

@@ -1,5 +1,5 @@
 import { type AiTaskProps } from './types';
-export declare function AiTask({ task, density, indent, className, strings: stringsProp, }: AiTaskProps): import("react").JSX.Element;
+export declare function AiTask({ task, density, indent, surface, className, strings: stringsProp, }: AiTaskProps): import("react").JSX.Element;
 export declare namespace AiTask {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-task/types.d.ts

@@ -1,6 +1,7 @@
 import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export type AiTaskStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'skipped';
 export interface AiTaskItem {
     /** Stable identity for this entry. */
@@ -27,10 +28,18 @@ export declare const defaultAiTaskStrings: AiTaskStrings;
 export interface AiTaskProps {
     /** Top-level task. */
     task: AiTaskItem;
-    /** Compact = single row with collapsible children; expanded = always show. */
+    /**
+     * Compact = nested rows start collapsed; expanded = every row starts open.
+     * Changing it re-seeds every row; a toggle made afterwards still wins.
+     */
     density?: 'compact' | 'expanded';
     /** Indentation width per nesting level (px). */
     indent?: number;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai-tool-call/ai-tool-call.d.ts

@@ -1,5 +1,5 @@
 import { type AiToolCallProps } from './types';
-export declare function AiToolCall({ name, status, icon: IconComponent, args, result, error, durationMs, expanded: expandedProp, defaultExpanded, onExpandedChange, className, strings: stringsProp, }: AiToolCallProps): import("react").JSX.Element;
+export declare function AiToolCall({ name, status, icon: IconComponent, args, result, error, durationMs, expanded: expandedProp, defaultExpanded, onExpandedChange, surface, className, strings: stringsProp, }: AiToolCallProps): import("react").JSX.Element;
 export declare namespace AiToolCall {
     var displayName: string;
 }

package/dist/components/blocks/ai/ai-tool-call/types.d.ts

@@ -1,13 +1,16 @@
 import type { LucideIcon } from 'lucide-react';
 import type { ReactNode } from 'react';
 import type { StringsProp } from '../../../../lib/strings';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
 export type AiToolCallStatus = 'pending' | 'running' | 'success' | 'error';
 export interface AiToolCallStrings {
     pending: string;
     running: string;
     success: string;
     error: string;
+    /** Supplied overrides describe how to open the details. */
     expand: string;
+    /** Supplied overrides describe how to close the details. */
     collapse: string;
     args: string;
     result: string;
@@ -33,6 +36,11 @@ export interface AiToolCallProps {
     defaultExpanded?: boolean;
     /** Fired whenever the disclosure state changes. */
     onExpandedChange?: (expanded: boolean) => void;
+    /**
+     * Outer chrome. `card` (default) frames the block; `flat` drops the frame
+     * so a composing `Card` or message surface owns it.
+     */
+    surface?: CardSurface;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/blocks/ai/ai.strings.d.ts

@@ -34,5 +34,7 @@ export interface AiClassificationStrings {
         medium: string;
         high: string;
     };
+    /** Writes the complexity score against its maximum. Defaults to `"<score>/<max>"`. */
+    formatComplexity?: (score: number, max: number) => string;
 }
 export declare const defaultAiClassificationStrings: AiClassificationStrings;

package/dist/components/blocks/analytics/activity-heatmap/types.d.ts

@@ -5,7 +5,7 @@ export interface ActivityHeatmapDay {
     date: string;
     level: ActivityLevel;
 }
-export type ActivityHeatmapStrings = Pick<AnalyticsStrings, 'heatmapDayLabels' | 'heatmapMonthNames' | 'heatmapLegendLess' | 'heatmapLegendMore'>;
+export type ActivityHeatmapStrings = Pick<AnalyticsStrings, 'heatmapDayLabels' | 'heatmapMonthNames' | 'heatmapLegendLess' | 'heatmapLegendMore' | 'heatmapFormatCell'>;
 export interface ActivityHeatmapProps {
     /** Surface title. */
     title: string;

package/dist/components/blocks/analytics/analytics.strings.d.ts

@@ -31,5 +31,7 @@ export interface AnalyticsStrings {
     heatmapLegendLess: string;
     /** Heatmap legend "more" label (right edge of intensity legend). */
     heatmapLegendMore: string;
+    /** Writes a heatmap day's tooltip from its date and level (0–4). Defaults to `"<date>: Level <level>"`. */
+    heatmapFormatCell?: (date: string, level: number) => string;
 }
 export declare const defaultAnalyticsStrings: AnalyticsStrings;

package/dist/components/blocks/analytics/atoms/metric-trend-chip.d.ts

@@ -1,4 +1,12 @@
+import { type StringsProp } from '../../../../lib/strings';
 import type { MetricChange, MetricSize, MetricTrend, MetricTrendVariant } from '../types';
+export interface MetricTrendChipStrings {
+    /** Direction in words, read out before the value. */
+    up: string;
+    down: string;
+    neutral: string;
+}
+export declare const defaultMetricTrendChipStrings: MetricTrendChipStrings;
 export interface MetricTrendChipProps {
     change: MetricChange;
     trend?: MetricTrend;
@@ -8,8 +16,10 @@ export interface MetricTrendChipProps {
     variant?: MetricTrendVariant;
     /** Merged onto the outermost node. */
     className?: string;
+    /** Overrides the direction words. */
+    strings?: StringsProp<MetricTrendChipStrings>;
 }
-export declare function MetricTrendChip({ change, trend, size, variant, className, }: MetricTrendChipProps): import("react").JSX.Element;
+export declare function MetricTrendChip({ change, trend, size, variant, className, strings: stringsProp, }: MetricTrendChipProps): import("react").JSX.Element;
 export declare namespace MetricTrendChip {
     var displayName: string;
 }

package/dist/components/blocks/analytics/chart-card/chart-card.d.ts

@@ -8,8 +8,10 @@
  */
 import type { ComponentProps, ReactNode } from 'react';
 import { ChartContainer, type ChartConfig, type ChartInitialDimension } from '../../../base/chart';
-import type { CardSurface, ComponentScale } from '../../../../lib/component-vocabulary';
-export type ChartCardPadding = ComponentScale;
+import { type CardProps } from '../../../base/cards';
+import type { CardSurface } from '../../../../lib/component-vocabulary';
+/** Card's inset scale, including `none` for a chart placed inside an existing boundary. */
+export type ChartCardPadding = NonNullable<CardProps['padding']>;
 export type ChartCardSurface = CardSurface;
 export interface ChartCardProps {
     /** Surface title. */
@@ -25,9 +27,9 @@ export interface ChartCardProps {
     config: ChartConfig;
     children: ComponentProps<typeof ChartContainer>['children'];
     initialDimension?: ChartInitialDimension;
-    /** Outer chrome. */
+    /** Outer chrome. Omit it to stay card-free. */
     surface?: ChartCardSurface;
-    /** Surface inset. */
+    /** Surface inset. Defaults to `none` when unframed and `md` on a framed surface. */
     padding?: ChartCardPadding;
     /** Merged onto the outermost node. */
     className?: string;
@@ -36,7 +38,7 @@ export interface ChartCardProps {
     /** Merged onto the chart. */
     chartClassName?: string;
 }
-export declare function ChartCard({ title, description, headerEnd, titleSuffix, footer, config, children, initialDimension, surface, padding, className, contentClassName, chartClassName, }: ChartCardProps): import("react").JSX.Element;
+export declare function ChartCard({ title, description, headerEnd, titleSuffix, footer, config, children, initialDimension, surface, padding: paddingProp, className, contentClassName, chartClassName, }: ChartCardProps): import("react").JSX.Element;
 export declare namespace ChartCard {
     var displayName: string;
 }

package/dist/components/blocks/analytics/charts/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Analytics charts — every analytics block that draws with Recharts.
+ *
+ * `recharts` is an optional peer. These blocks live in their own exact entry
+ * (`themelia-react-ui/blocks/analytics/charts`) so that importing the
+ * chart-free analytics blocks from `themelia-react-ui/blocks/analytics` never
+ * loads it.
+ *
+ *   - Metric              — single metric (7 variants); draws a sparkline
+ *   - MetricBar           — horizontal strip of Metric cells
+ *   - MetricGrid          — responsive grid of Metric cells
+ *   - MetricMicroGrid     — 6-cell dense overview with mini charts
+ *   - MetricGradient      — hero card with an embedded area chart
+ *   - MetricSparkline     — the area mini chart on its own
+ *   - ChartCard           — chart surface for custom Recharts children
+ *
+ * The shared metric types are re-exported here so one import covers a metric
+ * and its data shape; they are type-only and add nothing at runtime.
+ */
+export type { MetricChange, MetricData, MetricDataPoint, MetricDirection, MetricPeriod, MetricSize, MetricTrend, MetricTrendVariant, MetricValueType, MetricVariant, } from '../types';
+export { MetricSparkline, type MetricSparklineProps } from '../atoms/metric-sparkline';
+export { Metric, type MetricProps } from '../metric';
+export { MetricBar, type MetricBarProps, type MetricBarVariant } from '../metric-bar';
+export { MetricGrid, type MetricGridProps } from '../metric-grid';
+export { MetricMicroGrid, type MetricMicroGridProps, type MicroChartKind, type MicroMetricCell, } from '../metric-micro-grid';
+export { MetricGradient, type MetricGradientProps, type MetricGradientTheme, } from '../metric-gradient';
+export { ChartCard, type ChartCardProps } from '../chart-card';