themelia-react-ui 2.0.6 → 3.0.0

package/dist/components/base/sidebar/sidebar.d.ts

@@ -13,6 +13,8 @@ import { type StringsProp } from '../../../lib/strings';
 export interface SidebarStrings {
     mobileTitle: string;
     mobileDescription: string;
+    /** Accessible name of `SidebarTrigger` and `SidebarRail`. Optional so existing complete string objects stay valid. */
+    toggle?: string;
 }
 export declare const defaultSidebarStrings: SidebarStrings;
 export interface SidebarProps extends React.ComponentProps<'div'> {
@@ -40,7 +42,15 @@ type SidebarFooterProps = React.ComponentProps<typeof SidebarFooterPrimitive>;
 type SidebarGroupProps = React.ComponentProps<typeof SidebarGroupPrimitive>;
 type SidebarGroupActionProps = React.ComponentProps<typeof SidebarGroupActionPrimitive>;
 type SidebarGroupContentProps = React.ComponentProps<typeof SidebarGroupContentPrimitive>;
-type SidebarGroupLabelProps = React.ComponentProps<typeof SidebarGroupLabelPrimitive>;
+type SidebarGroupLabelProps = React.ComponentProps<typeof SidebarGroupLabelPrimitive> & {
+    /**
+     * A static heading: content height and no bottom margin, so the surrounding
+     * gap owns the rhythm. Defaults to `false`, the action-height label row.
+     */
+    compact?: boolean;
+};
+/** `secondary` rests on the sidebar's secondary text tier; hover and the current entry return to the full foreground. */
+export type SidebarRowTone = 'default' | 'secondary';
 type SidebarHeaderProps = React.ComponentProps<typeof SidebarHeaderPrimitive>;
 export interface SidebarInputProps extends React.ComponentProps<typeof SidebarInputPrimitive> {
     /** Accessible name when no visible label is associated with the navigation search. */
@@ -74,6 +84,8 @@ export interface SidebarMenuButtonProps extends Omit<React.ComponentProps<typeof
     size?: ComponentScale;
     /** Marks the navigation item as current. */
     active?: boolean;
+    /** Text tier of the resting row. Defaults to `default`. */
+    tone?: SidebarRowTone;
 }
 type SidebarMenuItemProps = React.ComponentProps<typeof SidebarMenuItemPrimitive>;
 export interface SidebarMenuSkeletonProps extends React.ComponentProps<'div'> {
@@ -82,10 +94,15 @@ export interface SidebarMenuSkeletonProps extends React.ComponentProps<'div'> {
     /** Deterministic text-bar width. @default "72%" */
     width?: string;
 }
-type SidebarMenuSubProps = React.ComponentProps<typeof SidebarMenuSubPrimitive>;
+type SidebarMenuSubProps = React.ComponentProps<typeof SidebarMenuSubPrimitive> & {
+    /** Drops the list's end inset, so child rows reach the same end edge as their parent row. Defaults to `false`. */
+    flushEnd?: boolean;
+};
 export interface SidebarMenuSubButtonProps extends Omit<React.ComponentProps<typeof SidebarMenuSubButtonPrimitive>, 'isActive'> {
     /** Marks the nested navigation item as current. */
     active?: boolean;
+    /** Text tier of the resting row. Defaults to `default`. */
+    tone?: SidebarRowTone;
 }
 type SidebarMenuSubItemProps = React.ComponentProps<typeof SidebarMenuSubItemPrimitive>;
 export interface SidebarProviderProps extends React.ComponentProps<'div'>, SidebarStateProps {
@@ -106,9 +123,20 @@ export interface SidebarProviderProps extends React.ComponentProps<'div'>, Sideb
     /** Additional classes merged with the provider root. */
     className?: string;
 }
-type SidebarRailProps = React.ComponentProps<typeof SidebarRailPrimitive>;
+type SidebarToggleStrings = StringsProp<Pick<SidebarStrings, 'toggle'>>;
+type SidebarTriggerScale = 'sm' | 'md' | 'lg';
+type SidebarRailProps = Omit<React.ComponentProps<typeof SidebarRailPrimitive>, 'toggleLabel'> & {
+    /** Overrides the rail's accessible name. */
+    strings?: SidebarToggleStrings;
+};
 type SidebarSeparatorProps = React.ComponentProps<typeof SidebarSeparatorPrimitive>;
-type SidebarTriggerProps = React.ComponentProps<typeof SidebarTriggerPrimitive>;
+type RawSidebarTriggerProps = React.ComponentProps<typeof SidebarTriggerPrimitive>;
+type SidebarTriggerProps = Omit<RawSidebarTriggerProps, 'toggleLabel' | 'size' | 'variant'> & {
+    /** Overrides the trigger's accessible name. */
+    strings?: SidebarToggleStrings;
+    /** Button scale, matching the public `Button`. Defaults to `md`, the height of the header controls beside it. */
+    size?: SidebarTriggerScale;
+};
 declare function SidebarProvider({ className, style, menuDensity, ...props }: SidebarProviderProps): React.JSX.Element;
 export interface SidebarRegionProps extends Omit<React.ComponentProps<'div'>, 'ref'> {
     /** Ref to the semantic aside boundary. */
@@ -141,14 +169,14 @@ declare function SidebarMenuItem({ className, ...props }: SidebarMenuItemProps):
 declare function SidebarMenuAction({ className, ...props }: SidebarMenuActionProps): React.JSX.Element;
 declare function SidebarMenuBadge({ className, inline, size, children, ...props }: SidebarMenuBadgeProps): React.JSX.Element;
 declare function SidebarMenuSkeleton({ className, showIcon, style, width, ...props }: SidebarMenuSkeletonProps): React.JSX.Element;
-declare function SidebarMenuSub({ className, ...props }: SidebarMenuSubProps): React.JSX.Element;
+declare function SidebarMenuSub({ className, flushEnd, ...props }: SidebarMenuSubProps): React.JSX.Element;
 declare function SidebarMenuSubItem({ className, ...props }: SidebarMenuSubItemProps): React.JSX.Element;
 declare function SidebarInset({ className, ...props }: SidebarInsetProps): React.JSX.Element;
-declare function SidebarRail({ className, ...props }: SidebarRailProps): React.JSX.Element;
-declare function SidebarTrigger({ className, ...props }: SidebarTriggerProps): React.JSX.Element;
-declare function SidebarMenuButton({ className, render, size, tooltip, children, active, ...props }: SidebarMenuButtonProps): React.JSX.Element;
-declare function SidebarMenuSubButton({ className, children, active, ...props }: SidebarMenuSubButtonProps): React.JSX.Element;
-declare function SidebarGroupLabel({ className, children, ...props }: SidebarGroupLabelProps): React.JSX.Element;
+declare function SidebarRail({ className, strings: stringsProp, ...props }: SidebarRailProps): React.JSX.Element;
+declare function SidebarTrigger({ className, strings: stringsProp, size, ...props }: SidebarTriggerProps): React.JSX.Element;
+declare function SidebarMenuButton({ className, render, size, tooltip, children, active, tone, ...props }: SidebarMenuButtonProps): React.JSX.Element;
+declare function SidebarMenuSubButton({ className, children, active, tone, ...props }: SidebarMenuSubButtonProps): React.JSX.Element;
+declare function SidebarGroupLabel({ className, children, compact, ...props }: SidebarGroupLabelProps): React.JSX.Element;
 export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRegion, SidebarRail, SidebarSeparator, SidebarTrigger, };
 /** Internal bridge for the layout layer; not part of the base package entrypoint. */
 export declare const useBaseSidebarContext: typeof useSidebarPrimitive;

package/dist/components/base/skeleton/skeleton.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import { Skeleton as PrimitiveSkeleton } from '../../ui/skeleton';
 type DivProps = React.ComponentPropsWithoutRef<'div'>;
-export interface SkeletonProps extends React.ComponentPropsWithoutRef<typeof PrimitiveSkeleton> {
+export interface SkeletonProps extends React.ComponentProps<typeof PrimitiveSkeleton> {
 }
 export declare function Skeleton({ className, ...props }: SkeletonProps): React.JSX.Element;
 export declare namespace Skeleton {

package/dist/components/base/structure/structure.types.d.ts

@@ -6,14 +6,23 @@ export type TextGap = 'normal' | 'dense';
 export type StructureGap = TextGap | 'none' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 export type StructureAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
 export type StructureJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+/**
+ * Stack arranges its children and never sizes their content: a child that must
+ * truncate or shrink below its content in a horizontal stack takes `min-w-0`
+ * itself. Grid tracks are `minmax(0, 1fr)`, so content cannot widen a column.
+ */
 export interface StackProps extends useRender.ComponentProps<'div'> {
     /** Main axis. Every structure prop also accepts a per-breakpoint object. Defaults to `vertical`. */
     direction?: ResponsiveValue<'vertical' | 'horizontal'>;
     /** Space between children, on the semantic spacing scale. Defaults to `md`. */
     gap?: ResponsiveValue<StructureGap>;
-    /** Cross-axis alignment of children. */
+    /**
+     * Cross-axis alignment of children. A vertical stack defaults to `stretch`,
+     * so children fill its width; a horizontal one defaults to `center`. Use
+     * `start` to keep a child at its own width.
+     */
     align?: ResponsiveValue<StructureAlign>;
-    /** Main-axis distribution of children. */
+    /** Main-axis distribution of children. Defaults to `start`. */
     justify?: ResponsiveValue<StructureJustify>;
     /** Allows children to flow onto more than one line. Horizontal directions wrap by default. */
     wrap?: ResponsiveValue<boolean>;

package/dist/components/base/text-inputs/index.d.ts

@@ -15,7 +15,7 @@
  * behind `Input` and `Textarea`, not a composition seam.
  */
 export { Input, defaultInputStrings, type InputProps, type InputStrings } from './input';
-export { Textarea, type TextareaProps } from './textarea';
+export { Textarea, defaultTextareaStrings, type TextareaProps, type TextareaStrings } from './textarea';
 export { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, type InputGroupProps, type InputGroupAddonProps, type InputGroupButtonProps, type InputGroupInputProps, type InputGroupTextProps, type InputGroupTextareaProps, } from './input-group';
 export { PasswordInput, defaultPasswordInputStrings, type PasswordInputProps, type PasswordInputStrings, } from './password-input';
 export { SlugField, slugifyValue, type SlugFieldProps, type SlugifyValueOptions, } from './slug-field';

package/dist/components/base/tree/index.d.ts

@@ -1,2 +1,3 @@
 export { Tree } from './tree';
+export { defaultTreeStrings } from './tree.types';
 export type { TreeNode, TreeProps, TreeStrings } from './tree.types';

package/dist/components/base/tree/tree.d.ts

@@ -1,3 +1,3 @@
-import type { TreeProps } from './tree.types';
+import { type TreeProps } from './tree.types';
 /** Accessible data-driven hierarchy. Focus moves independently from selection. */
-export declare function Tree<T = unknown>({ items, expandedValues, defaultExpandedValues, onExpandedValuesChange, selectedValues, defaultSelectedValues, onSelectedValuesChange, selectionMode, branchActivation, disabled, density, rowLayout, indent, showGuides, empty, strings, renderLabel, className, onKeyDown, ...props }: TreeProps<T>): import("react").JSX.Element;
+export declare function Tree<T = unknown>({ items, expandedValues, defaultExpandedValues, onExpandedValuesChange, selectedValues, defaultSelectedValues, onSelectedValuesChange, selectionMode, branchActivation, disabled, density, rowLayout, indent, showGuides, empty, strings: stringsProp, renderLabel, className, onKeyDown, ...props }: TreeProps<T>): import("react").JSX.Element;

package/dist/components/base/tree/tree.types.d.ts

@@ -1,3 +1,4 @@
+import type { StringsProp } from '../../../lib/strings';
 import type { ComponentProps, ReactNode } from 'react';
 import type { RowDensity } from '../../../lib/row-recipes';
 /** Stable values must be unique throughout a hierarchy. */
@@ -19,7 +20,10 @@ export interface TreeNode<T = unknown> {
 export interface TreeStrings {
     expand: (label: string) => string;
     collapse: (label: string) => string;
+    /** Shown when there are no items. The `empty` prop overrides it with any node. */
+    empty: string;
 }
+export declare const defaultTreeStrings: TreeStrings;
 export interface TreeProps<T = unknown> extends Omit<ComponentProps<'div'>, 'children' | 'onSelect'> {
     items: readonly TreeNode<T>[];
     expandedValues?: readonly string[];
@@ -40,8 +44,10 @@ export interface TreeProps<T = unknown> extends Omit<ComponentProps<'div'>, 'chi
     indent?: number;
     /** Decorative guides retain the hierarchy at every nesting level. */
     showGuides?: boolean;
+    /** Replaces `strings.empty` with any node. */
     empty?: ReactNode;
-    strings?: Partial<TreeStrings>;
+    /** Overrides the tree's own copy; merged over `defaultTreeStrings`. */
+    strings?: StringsProp<TreeStrings>;
     /** Presentation slot only; interactive content should live outside the tree row. */
     renderLabel?: (node: TreeNode<T>) => ReactNode;
 }

package/dist/components/base/upload/file-upload.validation.d.ts

@@ -1,4 +1,4 @@
-import type { FileUploadRejection, FileUploadValidator } from './file-upload.types';
+import type { FileUploadRejection, FileUploadRejectionCode, FileUploadValidator } from './file-upload.types';
 import type { FileUploadStrings } from './file-upload.strings';
 interface ValidateFileSelectionOptions {
     incoming: File[];
@@ -17,5 +17,41 @@ export interface FileSelectionResult {
     nextFiles: File[];
     rejections: FileUploadRejection[];
 }
+/** The native `accept` rule: extensions (`.pdf`), wildcards (`image/*`) and exact MIME types. An empty rule accepts every file. */
+export declare function matchesFileAccept(file: File, accept?: string): boolean;
+/** File rules shared by every upload surface. All are optional. */
+export interface FileValidationRules {
+    /** Native `accept` value: extensions, wildcards and MIME types, comma-separated. */
+    accept?: string;
+    /** Smallest accepted size in bytes. */
+    minSizeBytes?: number;
+    /** Largest accepted size in bytes. */
+    maxSizeBytes?: number;
+    /** Most files held at once, counting those already chosen. */
+    maxFiles?: number;
+    /** Return `true` to accept, `false` to reject, or a message to reject with that copy. */
+    validateFile?: FileUploadValidator;
+}
+export interface FileValidationRejection {
+    file: File;
+    /** Stable reason; the owner supplies the copy. */
+    code: FileUploadRejectionCode;
+    /** Present only when a custom validator returned its own message. */
+    message?: string;
+}
+export interface FileValidationResult {
+    /** Incoming files that passed every rule, in order. */
+    accepted: File[];
+    /** `current` followed by `accepted`. */
+    nextFiles: File[];
+    rejections: FileValidationRejection[];
+}
+/**
+ * The one file validator: type, size, custom rule, duplicates and count, in
+ * that order. It performs no transfer and holds no copy; rejections carry a
+ * stable code so each surface words them through its own strings.
+ */
+export declare function validateFiles(incoming: readonly File[], rules?: FileValidationRules, current?: readonly File[]): FileValidationResult;
+/** FileUpload's adapter: the shared rules plus its own localized copy. */
 export declare function validateFileSelection({ incoming, current, accept, minSizeBytes, maxSizeBytes, maxFiles, append, validateFile, formatSize, strings, }: ValidateFileSelectionOptions): FileSelectionResult;
 export {};

package/dist/components/base/upload/image-upload.d.ts

@@ -53,6 +53,8 @@ export interface ImageUploadProps extends FieldControlAttributes {
     invalid?: boolean;
     /** Override default strings (button labels, helper text, supports template). */
     strings?: StringsProp<ImageUploadStrings>;
+    /** Additional classes merged onto the control root. */
+    className?: string;
 }
 declare const ImageUpload: React.ForwardRefExoticComponent<ImageUploadProps & React.RefAttributes<HTMLInputElement>>;
 export { ImageUpload };

package/dist/components/base/upload/index.d.ts

@@ -7,20 +7,14 @@
  *
  * `FileUpload` is the form-shaped control for local `File` values. `Dropzone`
  * is the bare drop target it composes, `ImageUpload` / `AvatarUpload` add
- * image previews. Transfer-state surfaces and ordered media editing now have
- * canonical `base/upload-queue` and `base/media-gallery` entrypoints; their
- * 1.x compatibility exports remain below.
+ * image previews. Transfer-state surfaces live in `base/upload-queue` and
+ * ordered media editing in `base/media-gallery`.
  *
  * `useFileDropTarget` and `FilePickerInput` stay internal — they are the
  * shared drag/keyboard plumbing behind the public controls, not an API.
  */
 export { Dropzone, defaultDropzoneStrings, type DropzoneProps, type DropzoneInputProps, type DropzoneStrings, type DropzoneSize, } from './dropzone';
 export { FileUpload, defaultFileUploadStrings, type FileUploadProps, type FileUploadCommonProps, type FileUploadRejection, type FileUploadRejectionCode, type FileUploadSelectionMode, type FileUploadStrings, type FileUploadValidator, type MultipleFileUploadProps, type SingleFileUploadProps, } from './file-upload';
+export { matchesFileAccept, validateFiles, type FileValidationRejection, type FileValidationResult, type FileValidationRules, } from './file-upload.validation';
 export { ImageUpload, defaultImageUploadStrings, type ImageUploadProps, type ImageUploadStrings, } from './image-upload';
 export { AvatarUpload, defaultAvatarUploadStrings, type AvatarUploadProps, type AvatarUploadStrings, type AvatarUploadSize, } from './avatar-upload';
-/** @deprecated Import from `themelia-react-ui/base/media-gallery`. Kept through 1.x. */
-export { MediaGallery, defaultMediaGalleryStrings, type MediaGalleryProps, type MediaGalleryStrings, } from '../media-gallery';
-/** @deprecated Import from `themelia-react-ui/base/upload-queue`. Kept through 1.x. */
-export { UploadProgressList, defaultUploadProgressListStrings, type UploadProgressListProps, type UploadProgressListStrings, type UploadItem, type UploadStatus, } from '../upload-queue';
-/** @deprecated Import from `themelia-react-ui/base/upload-queue`. Kept through 1.x. */
-export { UploadTray, defaultUploadTrayStrings, type UploadTrayProps, type UploadTrayStrings, } from '../upload-queue';

package/dist/components/base/value-inputs/date-time-input.d.ts

@@ -2,6 +2,8 @@ import type { DatePickerBaseProps } from '../date-pickers/datepicker.types';
 export interface DateTimeInputProps extends Pick<DatePickerBaseProps, 'triggerRef' | 'onBlur' | 'aria-describedby' | 'aria-invalid'> {
     /** Controlled value (ISO string) */
     value?: string;
+    /** Initial value (ISO string) while uncontrolled. */
+    defaultValue?: string;
     /** Change handler */
     onValueChange?: (value: string | undefined) => void;
     /** Placeholder text */
@@ -18,5 +20,7 @@ export interface DateTimeInputProps extends Pick<DatePickerBaseProps, 'triggerRe
     disabled?: boolean;
     /** Id of the trigger, so an external `<FormField label>` names it. Defaults to a generated id. */
     id?: string;
+    /** Additional classes merged onto the picker root. */
+    className?: string;
 }
 export declare const DateTimeInput: import("react").ForwardRefExoticComponent<DateTimeInputProps & import("react").RefAttributes<HTMLDivElement>>;

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;
@@ -33,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. */