themelia-react-ui 2.0.5 → 2.0.6

package/dist/components/features/filters/partials/filter-popover-content.d.ts

@@ -1,9 +1,11 @@
 import { type ComponentProps } from 'react';
 import { PopoverContent } from '../../../base/popover';
-import { type FilterConfig, type FilterTriggerSource } from '../filters.types';
+import { type FilterConfig, type FilterOperator, type FilterTriggerSource } from '../filters.types';
 export interface FilterPopoverContentProps {
     /** Which filter the popover is currently editing. */
     activeFilterInPopover: FilterConfig | null;
+    /** Active operator when the caller already owns the displayed selection. */
+    operator?: FilterOperator;
     /** Filters the user may add. */
     availableFilters: FilterConfig[];
     /** Filters currently applied. */
@@ -33,4 +35,4 @@ export interface FilterPopoverContentProps {
  * The component is used to wrap filter content in a consistent
  * popover interface across different filter types.
  */
-export declare function FilterPopoverContent({ activeFilterInPopover, availableFilters, activeFilters, getFilterValue, setFilterValue, onFilterSelect, onBackToFilterList, onClose, triggerSource, finalFocus, }: FilterPopoverContentProps): import("react").JSX.Element;
+export declare function FilterPopoverContent({ activeFilterInPopover, operator, availableFilters, activeFilters, getFilterValue, setFilterValue, onFilterSelect, onBackToFilterList, onClose, triggerSource, finalFocus, }: FilterPopoverContentProps): import("react").JSX.Element;

package/dist/components/features/filters/partials/range-filter-content.d.ts

@@ -0,0 +1,12 @@
+import type { FilterConfig, FilterOperator, FilterTriggerSource } from '../filters.types';
+interface RangeFilterContentProps {
+    filter: FilterConfig;
+    operator: FilterOperator;
+    value: string[];
+    onFilterChange: (value: string[]) => void;
+    onBackToFilterList: () => void;
+    onClose: () => void;
+    triggerSource: FilterTriggerSource;
+}
+export declare function RangeFilterContent({ filter, operator, value, onFilterChange, onBackToFilterList, onClose, triggerSource }: RangeFilterContentProps): import("react").JSX.Element;
+export {};

package/dist/components/features/filters/utils/filter-utils.d.ts

@@ -1,6 +1,10 @@
 import type { ReactNode } from 'react';
 import type { CascaderNode } from '../../../base/cascader';
-import type { FilterConfig, FilterDependency, FilterOption } from '../filters.types';
+import type { FilterConfig, FilterDependency, FilterOperator, FilterOption } from '../filters.types';
+export declare function getRangeBounds(value: readonly string[], operator?: FilterOperator): [min: string, max: string];
+export declare function isCompleteDateRange(value: readonly string[]): boolean;
+/** Filter dates use local calendar days or the app's explicit parameter format. */
+export declare function parseFilterDate(value: string | undefined, pattern?: string): Date | undefined;
 /**
  * The option for a value and its ancestors, searching nested options.
  */

package/dist/components/features/media-library/hooks/use-media-library.d.ts

@@ -2,4 +2,4 @@ import type { MediaLibraryAccessors, MediaLibraryItem, ResolvedMediaLibraryAcces
 export declare function resolveMediaLibraryAccessors<TItem = MediaLibraryItem>(accessors?: MediaLibraryAccessors<TItem>): ResolvedMediaLibraryAccessors<TItem>;
 export declare function formatMediaLibrarySize(bytes?: number): string;
 export declare function getMediaLibraryDimensions<TItem>(item: TItem, accessors: ResolvedMediaLibraryAccessors<TItem>): string;
-export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, selecting: selectingProp, defaultSelecting, onSelectingChange, }?: UseMediaLibraryOptions<TItem>): MediaLibraryState<TItem>;
+export declare function useMediaLibrary<TItem = MediaLibraryItem>({ items: itemsProp, fetcher, refreshKey, accessors: accessorsProp, selectionMode, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onUpload, onError, tab: tabProp, defaultTab, onTabChange, view: viewProp, defaultView, onViewChange, query: queryProp, defaultQuery, onQueryChange, type: typeProp, defaultType, onTypeChange, collection: collectionProp, defaultCollection, onCollectionChange, sort: sortProp, defaultSort, onSortChange, uploadOptions: uploadOptionsProp, defaultUploadOptions, onUploadOptionsChange, selecting: selectingProp, defaultSelecting, onSelectingChange, }?: UseMediaLibraryOptions<TItem>): MediaLibraryState<TItem>;

package/dist/components/features/media-library/media-library.d.ts

@@ -1,3 +1,3 @@
 import type { MediaLibraryDialogProps, MediaLibraryProps } from './media-library.types';
-export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, bulkActions, strings: stringsProp, slots, heightClassName, className, items, fetcher, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onItemOpen, onUpload, onError, selecting, defaultSelecting, onSelectingChange, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibrary<TItem = import('./media-library.types').MediaLibraryItem>({ title, titleSuffix, description, confirmLabel, cancelLabel, selectionMode, density, showMeta, allowUpload, typeFilters, confirmOnSelect, onConfirm, onCancel, onClose, bulkActions, strings: stringsProp, slots, heightClassName, className, items, fetcher, refreshKey, accessors, collections, value, defaultValue, onValueChange, onItemUpdate, onItemDelete, onItemReplace, onItemOpen, onUpload, onError, selecting, defaultSelecting, onSelectingChange, tab, defaultTab, onTabChange, view, defaultView, onViewChange, query, defaultQuery, onQueryChange, type, defaultType, onTypeChange, collection, defaultCollection, onCollectionChange, sort, defaultSort, onSortChange, uploadOptions, defaultUploadOptions, onUploadOptionsChange, ...props }: MediaLibraryProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryDialog<TItem = import('./media-library.types').MediaLibraryItem>({ open, onOpenChange, trigger, dialogTitle, dialogDescription, onClose, className, dialogClassName, contentClassName, closeOnEscape, closeOnBackdropClick, ...props }: MediaLibraryDialogProps<TItem>): import("react").JSX.Element;

package/dist/components/features/media-library/media-library.strings.d.ts

@@ -81,6 +81,11 @@ export interface MediaLibraryStrings {
         replace: string;
         delete: string;
         close: string;
+        mutationError?: string;
+        confirmDeleteTitle?: string;
+        confirmDeleteDescription?: string;
+        confirmDeleteLabel?: string;
+        confirmDeleteError?: string;
     };
     upload: {
         dropTitle: string;
@@ -96,6 +101,7 @@ export interface MediaLibraryStrings {
         removeFile: string;
         uploading: string;
         done: string;
+        error?: string;
     };
     footer: {
         pickOne: string;

package/dist/components/features/media-library/media-library.types.d.ts

@@ -89,6 +89,8 @@ export type MediaLibraryFetcher<TItem = MediaLibraryItem> = (params: MediaLibrar
 export interface MediaLibraryUploadHelpers {
     /** Aborted when the user cancels or the media-library instance unmounts. */
     signal: AbortSignal;
+    /** IDs in the same order as the files passed to this upload call. */
+    fileIds?: readonly string[];
     setProgress: (fileId: string, progress: number) => void;
     setFileStatus: (fileId: string, status: MediaLibraryUploadStatus, error?: string) => void;
 }
@@ -154,6 +156,9 @@ export interface MediaLibraryDetailRenderContext<TItem = MediaLibraryItem> {
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
     update: (patch: MediaLibraryItemPatch) => Promise<boolean>;
+    /** The most recent failed mutation for this asset. */
+    mutationError?: MediaLibraryState<TItem>['mutationError'];
+    /** In MediaLibrary, resolves after the user confirms or cancels removal. */
     remove: () => Promise<boolean>;
     /** Requests the consumer's replacement workflow for this inspected item, when supported. */
     replace?: () => void;
@@ -185,7 +190,7 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     visibleItems: TItem[];
     /** Ids of the currently selected assets. */
     selectedIds: string[];
-    /** The currently selected assets, resolved from their ids. */
+    /** The selected assets that have been loaded or uploaded, including earlier server results. */
     selectedItems: TItem[];
     /** Ids of the currently selected assets, for fast lookup per row. */
     selectedSet: Set<string>;
@@ -200,7 +205,20 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     setSelecting: (selecting: boolean) => void;
     clearFilters: () => void;
     loading: boolean;
+    /** Whether remote or newly uploaded results are available during a request. */
+    hasLoadedResults?: boolean;
+    /** Legacy operation error. Cleared when the next load, mutation or upload starts. */
     error: unknown;
+    /** The current fetch failure. Local mode has no load error. */
+    loadError?: unknown;
+    /** The most recent failed update or delete, with the affected asset ID. */
+    mutationError?: {
+        itemId: string;
+        operation: 'update' | 'delete';
+        cause: unknown;
+    } | null;
+    /** The current upload request failure, separate from individual file statuses. */
+    uploadError?: unknown;
     /** Runs the fetcher again for the current query after a failure; does nothing in local mode. */
     retry: () => void;
     hasFilters: boolean;
@@ -218,9 +236,9 @@ export interface MediaLibraryState<TItem = MediaLibraryItem> {
     uploading: boolean;
     startUpload: () => Promise<void>;
     cancelUpload: () => void;
-    /** Resolves `false` after rollback when the consumer mutation fails. */
+    /** Requires `onItemUpdate`. Resolves `false` when unavailable or after a failed edit rolls back. */
     updateItem: (item: TItem, patch: MediaLibraryItemPatch) => Promise<boolean>;
-    /** Resolves `false` after rollback when the consumer mutation fails. */
+    /** Requires `onItemDelete`. Resolves `false` when unavailable or after a failed delete rolls back. */
     removeItem: (item: TItem) => Promise<boolean>;
     /** Reads id, name, URL, type, and size off your own asset shape. */
     accessors: ResolvedMediaLibraryAccessors<TItem>;
@@ -246,6 +264,8 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
      * the returned assets itself.
      */
     fetcher?: MediaLibraryFetcher<TItem>;
+    /** Change this key to reload the current remote query. Callback identity alone does not reload it. */
+    refreshKey?: string | number;
     /**
      * Reads id, name, URL, type, and size off your own asset shape. Omit only
      * when items already match `MediaLibraryItem`.
@@ -259,11 +279,11 @@ export interface UseMediaLibraryOptions<TItem = MediaLibraryItem> {
     value?: readonly string[];
     /** Initially selected asset ids, for uncontrolled use. */
     defaultValue?: readonly string[];
-    /** Fired with the selected ids and their resolved assets. */
+    /** Fired with every selected id and the records loaded or uploaded so far. */
     onValueChange?: (ids: string[], items: TItem[]) => void;
-    /** Applies an edit to an asset's metadata. May be awaited. */
+    /** Applies a metadata edit. Without it, details are read-only. May be awaited. */
     onItemUpdate?: (item: TItem, patch: MediaLibraryItemPatch) => void | Promise<void>;
-    /** Removes an asset. May be awaited. */
+    /** Persists removal. The built-in library asks for confirmation and only offers Delete with this callback. */
     onItemDelete?: (item: TItem) => void | Promise<void>;
     /** Fired when an entry is uploaded. */
     onUpload?: MediaLibraryUploadHandler<TItem>;
@@ -360,7 +380,7 @@ export interface MediaLibraryProps<TItem = MediaLibraryItem> extends Omit<Compon
      * and skipping the footer. Suits single-select pickers.
      */
     confirmOnSelect?: boolean;
-    /** Fired with the chosen assets and their ids. */
+    /** Fired with every chosen ID and the selected records loaded or uploaded so far. */
     onConfirm?: (items: TItem[], ids: string[]) => void;
     /** Fired when the user backs out without choosing. */
     onCancel?: () => void;
@@ -534,8 +554,14 @@ export interface MediaLibraryDetailPanelProps<TItem = MediaLibraryItem> {
     strings: MediaLibraryStrings;
     onClose: () => void;
     onUpdate: (patch: MediaLibraryItemPatch) => Promise<boolean>;
-    /** Fired when an entry is removed. */
+    /** Keeps metadata visible while preventing edits. */
+    readOnly?: boolean;
+    /** A failed mutation for the inspected asset. */
+    mutationError?: MediaLibraryState<TItem>['mutationError'];
+    /** Requests removal. */
     onRemove: () => Promise<boolean>;
+    /** Offers the Delete action and enables removal from custom details. Defaults to true. */
+    allowDelete?: boolean;
     /** Opens the consumer-owned replacement workflow for the inspected item. */
     onReplace?: () => void;
     /** Replaces the default detail rendering. */
@@ -550,6 +576,8 @@ export interface MediaLibraryUploadPanelProps {
     collections?: readonly MediaLibraryCollectionOption[];
     /** Whether an upload is in flight. */
     uploading?: boolean;
+    /** Shows an inline notice for a failed upload request. */
+    hasUploadError?: boolean;
     /** Overrides this surface's own copy. */
     strings: MediaLibraryStrings;
     onFiles: (files: File[]) => void;

package/dist/components/features/media-library/partials/media-library-partials.d.ts

@@ -3,8 +3,8 @@ export declare function MediaLibraryEmptyState({ icon, title, description, actio
 export declare function MediaLibraryToolbar({ query, type, typeFilters, collection, sort, view, collections, strings, onQueryChange, onTypeChange, onCollectionChange, onSortChange, onViewChange, onClearFilters, toolbarEnd, selecting, onSelectingChange, summary, disabled, }: MediaLibraryToolbarProps): import("react").JSX.Element;
 export declare function MediaLibraryCard<TItem>({ item, selected, density, showMeta, accessors, strings, onToggle, onDetails, onOpen, selecting, className, }: MediaLibraryCardProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryList<TItem>({ items, selectedSet, accessors, strings, onToggle, onDetails, onOpen, selecting, }: MediaLibraryListProps<TItem>): import("react").JSX.Element;
-export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, onRemove, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
-export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, strings, onFiles, onRemoveFile, onOptionsChange, empty, }: MediaLibraryUploadPanelProps): import("react").JSX.Element;
+export declare function MediaLibraryDetailPanel<TItem>({ item, collections, accessors, strings, onClose, onUpdate, readOnly, mutationError, onRemove, allowDelete, onReplace, renderDetail, }: MediaLibraryDetailPanelProps<TItem>): import("react").JSX.Element | null;
+export declare function MediaLibraryUploadPanel({ stagedFiles, uploadOptions, collections, uploading, hasUploadError, strings, onFiles, onRemoveFile, onOptionsChange, empty, }: MediaLibraryUploadPanelProps): import("react").JSX.Element;
 export declare function MediaLibraryFooterSummary({ tab, selectedIds, selectionMode, stagedFiles, strings, onClearSelection, className, }: MediaLibraryFooterSummaryProps): import("react").JSX.Element;
-export declare function MediaLibraryFooterActions<TItem>({ tab, selectedItems, selectedIds, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onUpload, onCancelUpload, className, }: MediaLibraryFooterActionsProps<TItem>): import("react").JSX.Element;
+export declare function MediaLibraryFooterActions<TItem>({ tab, selectedIds, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onUpload, onCancelUpload, className, }: MediaLibraryFooterActionsProps<TItem>): import("react").JSX.Element;
 export declare function MediaLibraryFooter<TItem>({ tab, selectedItems, selectedIds, selectionMode, stagedFiles, uploading, strings, confirmLabel, cancelLabel, onCancel, onConfirm, onClearSelection, onUpload, onCancelUpload, chrome, className, }: MediaLibraryFooterProps<TItem>): import("react").JSX.Element;

package/dist/components/features/mentions/hooks/use-mentions.d.ts

@@ -1,4 +1,4 @@
-import type { RefObject } from 'react';
+import type { FocusEvent, RefObject } from 'react';
 import type { Mention, MentionSuggestion } from '../mentions.types';
 import { type UseMentionsSearchOptions, type UseMentionsSearchReturn } from './use-mentions-search';
 /**
@@ -25,6 +25,21 @@ export interface UseMentionsReturn<TResource extends string = string> extends Us
     triggerActive: boolean;
     /** Wire to the editor's `onCaretChange` to enable inline triggers. */
     handleCaretChange: () => void;
+    /** Whether the inline suggestions panel is open. */
+    inlineOpen: boolean;
+    /** ID to pass to the inline suggestion list. */
+    listboxId: string;
+    /** Highlighted option index, or -1 when no option is highlighted. */
+    activeIndex: number;
+    /** Completion metadata for the editable body while options are available. */
+    suggestionPopup?: {
+        listboxId: string;
+        activeOptionId?: string;
+    };
+    /** Handles inline navigation and returns whether the editor should consume the key. */
+    handleKeyDown: (event: KeyboardEvent) => boolean;
+    /** Bind to the wrapper containing both the editor and inline suggestions. */
+    handleBlur: (event: FocusEvent<HTMLElement>) => void;
     /**
      * Convert a suggestion into a Mention, register it, insert the chip
      * into the editor (replacing the trigger range when one is active),

package/dist/components/features/mentions/partials/mention-inline-suggestions.d.ts

@@ -17,6 +17,10 @@ export interface MentionInlineSuggestionsProps<TResource extends string = string
     suggestionsByKind?: Readonly<Record<string, ReadonlyArray<MentionSuggestion<TResource>>>>;
     /** Matches for the text typed after the trigger character. */
     suggestions: ReadonlyArray<MentionSuggestion<TResource>>;
+    /** ID shared with the editor's controlled listbox. */
+    listboxId?: string;
+    /** Highlighted option supplied by the editor's keyboard navigation. */
+    activeIndex?: number;
     /** Replaces the content with the loading state. */
     loading: boolean;
     /** Live query the panel echoes in the header; the consumer owns the editor input. */
@@ -33,4 +37,4 @@ export interface MentionInlineSuggestionsProps<TResource extends string = string
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function MentionInlineSuggestions<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, suggestionsByKind, suggestions, loading, query, onManualKindChange, onSelect, strings: stringsProp, className, }: MentionInlineSuggestionsProps<TResource>): import("react").JSX.Element | null;
+export declare function MentionInlineSuggestions<TResource extends string = string>({ open, activeKind, setActiveKind, kinds, resources, suggestionsByKind, suggestions, listboxId, activeIndex, loading, query, onManualKindChange, onSelect, strings: stringsProp, className, }: MentionInlineSuggestionsProps<TResource>): import("react").JSX.Element | null;

package/dist/components/features/mentions/utils/split-html-by-mentions.d.ts

@@ -1,10 +1,3 @@
-/**
- * Split an HTML string into a list of `html` chunks and `mention`
- * placeholders, keyed by the `data-ref-id` attribute the writer set.
- *
- * Used by `<MentionContent>` to render the body once with React chips
- * for the references and `dangerouslySetInnerHTML` for everything else.
- */
 export type MentionHtmlSegment = {
     kind: 'html';
     value: string;
@@ -13,4 +6,5 @@ export type MentionHtmlSegment = {
     refId: string;
     fallback: string;
 };
+/** @deprecated Render mentions within the original HTML tree with MentionContent. */
 export declare function splitHtmlByMentions(html: string): MentionHtmlSegment[];

package/dist/components/features/overlays/hooks/use-overlay-visibility.d.ts

@@ -11,7 +11,7 @@ export interface UseOverlayVisibilityOptions {
     defaultOpen?: boolean;
     /** Controlled visibility. Omit to let the hook own it. */
     open?: boolean;
-    /** Fired once for every actual visibility change. */
+    /** Fired for each request that differs from the current visibility. */
     onOpenChange?: (open: boolean) => void;
     /** Fired after a change to open. */
     onOpen?: () => void;
@@ -33,7 +33,7 @@ export interface UseOverlayVisibilityGroupOptions<TKey extends string = string>
     defaultOpen?: Partial<Record<TKey, boolean>>;
     /** Controlled visibility per key. */
     open?: Partial<Record<TKey, boolean>>;
-    /** Fired once for every actual change, with the key, its visibility and the next group state. */
+    /** Fired for each requested change, with the key, its visibility and the proposed group state. */
     onOpenChange?: (key: TKey, open: boolean, state: OverlayVisibilityGroupState<TKey>) => void;
     /** Opening one key closes the others, for one-at-a-time overlays. Default: `false`. */
     closeOthersOnOpen?: boolean;

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

@@ -290,7 +290,7 @@ export interface ProductOptionValue {
 export interface ProductOptionGroup {
     /** Stable identity for this entry. */
     id: string;
-    /** Display name. */
+    /** Display name. Inline configuration requires text or a number. Use onEditOption for rich names. */
     name: ReactNode;
     /** Supporting copy shown under the label. */
     description?: ReactNode;
@@ -835,7 +835,7 @@ export interface ProductVariantOptionField {
     id: string;
     /** Display label. */
     label: string;
-    /** Value shown beside the label. */
+    /** Fallback for an absent option value. @deprecated Set value.options or defaultValue.options on ProductVariantEditor. */
     value?: string;
     choices?: ProductChoice[];
     placeholder?: string;

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

@@ -83,6 +83,9 @@ export interface QuestionnaireProps extends Omit<ComponentPropsWithoutRef<'form'
     /** Controlled active question key. */
     questionId?: string;
     defaultQuestionId?: string;
+    /** Fired when navigation requests a question. Takes precedence over `onQuestionChange`. */
+    onQuestionIdChange?: (id: string) => void;
+    /** Legacy alias for `onQuestionIdChange`. */
     onQuestionChange?: (id: string) => void;
     disabled?: boolean;
     /** Receives only visible, enabled questions. Respect signal to cancel application requests. */

package/dist/components/features/resource/resource.d.ts

@@ -8,5 +8,5 @@ export declare function ResourceIndexShell(props: ResourceIndexShellProps): impo
 /** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
 export declare function ResourceShowShell(props: ResourceShowShellProps): import("react").JSX.Element;
 /** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
-export declare function TabbedResourceShell({ tabs, activeTab, onTabChange, tabsClassName, moreLabel, tabsAriaLabel, toolbar, slots, className, strings: stringsProp, ...props }: TabbedResourceShellProps): import("react").JSX.Element;
+export declare function TabbedResourceShell({ tabs, activeTab, defaultActiveTab, onTabChange, tabsClassName, moreLabel, tabsAriaLabel, toolbar, slots, className, strings: stringsProp, ...props }: TabbedResourceShellProps): import("react").JSX.Element;
 export declare function ResourceDetailsSection({ metadata, metadataColumns, metadataDense, body, help, children, contentClassName, ...props }: ResourceDetailsSectionProps): import("react").JSX.Element;

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

@@ -188,6 +188,8 @@ export interface TabbedResourceShellProps extends ResourceShowShellProps {
     tabs: OverflowTabItem[];
     /** Controlled active tab identifier. */
     activeTab?: string;
+    /** Initial tab identifier when the shell manages selection. `activeTab` takes precedence. */
+    defaultActiveTab?: string;
     /** Called when a visible or overflow tab is selected. */
     onTabChange?: (id: string) => void;
     /** Class name for the overflow tab bar. */

package/dist/components/features/rich-text-editor/form-rich-text-editor.d.ts

@@ -3,4 +3,4 @@ export interface FormRichTextEditorProps extends Omit<RichTextEditorProps, 'valu
     /** Form field name, forwarded for native submits. */
     name: string;
 }
-export declare function FormRichTextEditor({ name, ...props }: FormRichTextEditorProps): import("react").JSX.Element;
+export declare function FormRichTextEditor({ name, className, disabled, invalid, onBlur, ...props }: FormRichTextEditorProps): import("react").JSX.Element;

package/dist/components/features/rich-text-editor/partials/caret-helpers.d.ts

@@ -24,5 +24,5 @@ export declare function readCaretContext(): RichTextCaretContext | null;
  * range with the chip atomically — no manual text-content mutation, no
  * timing races between "delete" and "insert".
  */
-export declare function replaceBeforeCaret(editor: TiptapEditor | null, length: number, html: string, notifyChange: (next: string) => void): void;
+export declare function replaceBeforeCaret(editor: TiptapEditor | null, length: number, html: string, notifyChange?: (next: string) => void): void;
 export declare function insertHtmlIntoEditable(editable: HTMLElement | null, html: string): void;

package/dist/components/features/rich-text-editor/partials/editor-field-aria.d.ts

@@ -0,0 +1,14 @@
+export declare function editorFieldAria(label: string, listboxId?: string, activeOptionId?: string): {
+    readonly role: "textbox";
+    readonly 'aria-label': string;
+    readonly 'aria-multiline': "true";
+} | {
+    readonly 'aria-activedescendant'?: string | undefined;
+    readonly role: "combobox";
+    readonly 'aria-label': string;
+    readonly 'aria-expanded': "true";
+    readonly 'aria-haspopup': "listbox";
+    readonly 'aria-autocomplete': "list";
+    readonly 'aria-controls': string;
+    readonly 'aria-multiline'?: undefined;
+};

package/dist/components/features/rich-text-editor/partials/rich-text-editor-toolbar.d.ts

@@ -6,6 +6,8 @@ export interface RichTextEditorToolbarProps {
     buttons: ToolbarButtonConfig[];
     /** Additional controls appended to the toolbar. */
     extraToolbarItems?: ReadonlyArray<RichTextEditorToolbarItem>;
+    /** Active values read from the editor's transaction subscription. */
+    extraToolbarActive?: readonly boolean[];
     /** Hides the control that switches to HTML source. */
     hideSourceToggle?: boolean;
     /** Whether the editor is currently showing HTML source. */
@@ -27,7 +29,7 @@ export interface RichTextEditorToolbarProps {
     /** Merged onto the outermost node. */
     className?: string;
 }
-export declare function RichTextEditorToolbar({ buttons, extraToolbarItems, hideSourceToggle, sourceMode, toggleSourceMode, disabled, hasEditor, toolbarTrailing, strings, className, }: RichTextEditorToolbarProps): import("react").JSX.Element;
+export declare function RichTextEditorToolbar({ buttons, extraToolbarItems, extraToolbarActive, hideSourceToggle, sourceMode, toggleSourceMode, disabled, hasEditor, toolbarTrailing, strings, className, }: RichTextEditorToolbarProps): import("react").JSX.Element;
 export declare namespace RichTextEditorToolbar {
     var displayName: string;
 }

package/dist/components/features/rich-text-editor/rich-text-editor.recipes.d.ts

@@ -11,7 +11,7 @@ export declare const richTextEditorRecipes: {
     readonly placeholder: "pointer-events-none absolute inset-0 p-surface-xs";
     /** Inline inset for the regions under the body (image details, counts, footer slot). */
     readonly regionX: "px-surface-xs";
-    readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-radius border";
+    readonly frame: string;
     readonly disabled: "opacity-50";
     readonly disabledControl: "disabled:opacity-100 aria-disabled:opacity-100";
     readonly content: "h-full [&_.ProseMirror]:h-full [&_.ProseMirror]:min-h-full [&_.ProseMirror]:outline-none";

package/dist/components/features/rich-text-editor/rich-text-editor.types.d.ts

@@ -1,5 +1,6 @@
-import type { ComponentType, ReactNode } from 'react';
+import type { ComponentType, FocusEventHandler, ReactNode } from 'react';
 import type * as TiptapReact from '@tiptap/react';
+import type { FieldControlAttributes } from '../../../lib/field-control-attributes';
 import type { StringsProp } from '../../../lib/strings';
 import type { RichTextImageRendering } from '../../typography/rich-text';
 import type { RichTextEditorStrings } from './rich-text-editor.strings';
@@ -94,11 +95,15 @@ export interface RichTextEditorImages extends RichTextImageRendering {
 }
 /** Body floor roles for the rich text editor. */
 export type RichTextEditorBodyHeight = 'control' | 'field' | 'document';
-export interface RichTextEditorProps {
+export interface RichTextEditorProps extends FieldControlAttributes {
     /** Editor content as HTML. Controlled. */
     value: string;
-    /** Fired with the next value. */
+    /** Reports the document HTML. Source edits commit when switching back to rich text. */
     onValueChange: (html: string) => void;
+    /** Includes the committed HTML under this name in native form submissions. */
+    name?: string;
+    /** Runs when focus leaves the editor and its toolbar. */
+    onBlur?: FocusEventHandler<HTMLElement>;
     /** Shown while the document is empty. */
     placeholder?: string;
     /** Tightens the toolbar and body for inline use. */
@@ -115,6 +120,8 @@ export interface RichTextEditorProps {
     maxHeight?: string;
     /** Renders the entry as unselectable. */
     disabled?: boolean;
+    /** Marks the editable field invalid and applies the shared field state. */
+    invalid?: boolean;
     /** Show character and word counts in a footer bar. */
     showCounts?: boolean;
     /** Optional character limit — displayed as "X / max" when showCounts is true. */
@@ -137,6 +144,13 @@ export interface RichTextEditorProps {
      * comment composer to detect `@`-style trigger characters.
      */
     onCaretChange?: () => void;
+    /** Consumes an editable-body key before the editor handles it. Return true to handle the key. */
+    onEditorKeyDown?: (event: KeyboardEvent) => boolean;
+    /** Associates the editable body with an open inline completion listbox. */
+    suggestionPopup?: {
+        listboxId: string;
+        activeOptionId?: string;
+    };
     /** Per-instance string overrides (deep-merged over `defaultRichTextEditorStrings`). */
     strings?: StringsProp<RichTextEditorStrings>;
     /**

package/dist/components/features/schema-form/hooks/use-schema-form.d.ts

@@ -15,9 +15,13 @@ export interface UseSchemaFormResult extends SchemaFormSubmitHelpers {
     errors: SchemaFormErrors;
     getFieldError: (key: string) => string | undefined;
     getFieldValue: (key: string) => SchemaFormValue;
+    /** Reads the latest values, including writes made in the current event. */
+    getValues: () => SchemaFormValues;
     setFieldValue: (key: string, value: SchemaFormValue) => void;
     setValues: (values: SchemaFormValues) => void;
+    /** Registers a field editor's current parse validity with form validation. */
+    setFieldParseValidity: (key: string, valid: boolean) => void;
     reset: () => SchemaFormValues;
     validate: () => boolean;
 }
-export declare function useSchemaForm({ fields, value, defaultValue, errors: externalErrors, onValueChange, onFieldChange, formatRequiredError, validationError, onError, }: UseSchemaFormOptions): UseSchemaFormResult;
+export declare function useSchemaForm(options: UseSchemaFormOptions): UseSchemaFormResult;

package/dist/components/features/schema-form/partials/schema-form-field.d.ts

@@ -5,8 +5,10 @@ export interface SchemaFormFieldRendererProps extends SchemaFormFieldContext {
     strings: SchemaFormStrings;
     /** Merged onto the outermost node. */
     className?: string;
+    /** Reports whether the JSON editor can parse its current draft. */
+    onParseValidityChange?: (key: string, valid: boolean) => void;
 }
-export declare function SchemaFormFieldRenderer({ field, value, values, error, disabled, required, fieldId, onValueChange, onError, strings, className, }: SchemaFormFieldRendererProps): import("react").JSX.Element;
+export declare function SchemaFormFieldRenderer({ field, value, values, error, disabled, required, fieldId, onValueChange, onError, strings, className, onParseValidityChange, }: SchemaFormFieldRendererProps): import("react").JSX.Element;
 export declare namespace SchemaFormFieldRenderer {
     var displayName: string;
 }

package/dist/components/features/schema-form/schema-form.utils.d.ts

@@ -10,7 +10,7 @@ export declare function toStringValue(value: SchemaFormValue): string;
 export declare function toStringArray(value: SchemaFormValue): string[];
 export declare function toBooleanValue(value: SchemaFormValue): boolean;
 export declare function parseNumberValue(rawValue: string, integer?: boolean): number | null;
-export declare function formatJsonValue(value: SchemaFormValue, indent?: number): string;
+export declare function formatJsonValue(value: SchemaFormValue, indent?: number, quoteString?: boolean): string;
 export declare function parseJsonValue(rawValue: string): {
     value: SchemaFormValue;
     valid: boolean;

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

@@ -68,7 +68,7 @@ export interface SuggestionsComboboxProps<T> extends UseSuggestionsConfig<T> {
     renderError?: (context: SuggestionsErrorRenderContext) => ReactNode;
     /** Shows a control that clears the current selection. */
     allowClear?: boolean;
-    /** Resets the query when the list closes without a selection. */
+    /** Resets the query when a results list closes. Failed queries remain available to retry. */
     clearInputOnClose?: boolean;
     /** Renders the entry as unselectable. */
     disabled?: boolean;

package/dist/components/features/table/data-table.d.ts

@@ -1,6 +1,6 @@
 export declare function useDataTableSize(): 'xs' | 'sm';
 import { type DataTableProps } from './table.types';
-export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableResizing, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, selectionToolbarPlacement, totalRowCount: totalRowCountProp, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+export declare function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, loading, loadingRows, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableResizing, enableFiltering, filterColumn, filterPlaceholder, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, enableSubRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateMessage, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, defaultSorting, columnVisibility: controlledColumnVisibility, defaultColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, selectionToolbarPlacement, totalRowCount: totalRowCountProp, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
 export declare namespace DataTable {
     var displayName: string;
 }

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

@@ -9,6 +9,7 @@ export { DataTableToolbar } from './table-toolbar';
 export { CellValue, CellStack, type CellStackProps, type CellStackValue, type CellValueDescriptor, type CellValueKind, type CellValueProps, type CellValueTuple, type PrimitiveCellValue, } from './partials/cell-value';
 export { TableLink, type TableLinkProps } from './partials/table-link';
 export { StatusCell, type StatusCellEntry, type StatusCellProps, StatusClusterCell, type StatusClusterCellItem, type StatusClusterCellProps, DateCell, type DateCellProps, DateMetaCell, type DateMetaCellProps, CurrencyCell, type CurrencyCellProps, AvatarCell, type AvatarCellProps, ResourceCell, type ResourceCellBadge, type ResourceCellLinkProps, type ResourceCellMetadataItem, type ResourceCellProps, } from './partials/cell-renderers';
+export type { ColumnDef } from '@tanstack/react-table';
 export * from './table.types';
 export { defaultDataTableStrings, mergeDataTableStrings } from './table.strings';
 export { handleRowSelectionChange, handleSortingChange, handleColumnVisibilityChange, getRowClassName, getCellClassName, getSelectedRowsData, createRowSelectionCheckbox, createHeaderSelectionCheckbox, addSelectionColumn, } from './table-helpers';

package/dist/components/features/table/table-body.d.ts

@@ -1,5 +1,5 @@
 import { type DataTableBodyProps } from './table.types';
-export declare function DataTableBody<TData>({ table, onRowClick, emptyStateMessage, emptyStateAction, cellClassName, rowClassName, stickyFirstColumn, striped, strings, }: DataTableBodyProps<TData>): import("react").JSX.Element;
+export declare function DataTableBody<TData>({ loading, loadingRows, table, onRowClick, emptyStateMessage, emptyStateAction, cellClassName, rowClassName, stickyFirstColumn, striped, strings, }: DataTableBodyProps<TData>): import("react").JSX.Element;
 export declare namespace DataTableBody {
     var displayName: string;
 }

package/dist/components/features/table/table-helpers.d.ts

@@ -1,6 +1,11 @@
 import type { SortingState, RowSelectionState, VisibilityState, Table, Row, Updater, ColumnDef } from '@tanstack/react-table';
 import React from 'react';
 import type { DataTableStrings } from './table.types';
+export interface GeneratedColumnOptions<TData> {
+    strings: DataTableStrings;
+    renderActions?: (row: TData) => React.ReactNode;
+}
+export declare function getGeneratedColumnOptions<TData>(table: Table<TData>): GeneratedColumnOptions<TData> | undefined;
 /**
  * Helper function for handling row selection changes with OnChangeFn compatibility
  */
@@ -33,7 +38,5 @@ export declare const createRowSelectionCheckbox: <TData>(row: Row<TData>, string
  * Create header selection checkbox
  */
 export declare const createHeaderSelectionCheckbox: <TData>(table: Table<TData>, strings?: DataTableStrings) => React.JSX.Element;
-/**
- * Add selection column to columns
- */
+/** Prepends the checkbox selection column. Explicit strings override table defaults. */
 export declare const addSelectionColumn: <TData, TValue = unknown>(columns: ColumnDef<TData, TValue>[], strings?: DataTableStrings) => ColumnDef<TData, TValue>[];

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

@@ -1,5 +1,8 @@
 import { type DataTableStrings, type DataTableStringsOverride } from './table.types';
 export declare const defaultDataTableStrings: {
+    loading: {
+        label: string;
+    };
     emptyState: {
         message: string;
         ariaLabel: string;