themelia-react-ui 2.0.6 → 3.0.0

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

@@ -398,8 +398,12 @@ export interface ProductOptionsMatrixProps {
      * when the app already confirms upstream, so the user is not asked twice.
      */
     confirmDelete?: boolean;
-    /** Fired when a value is added. */
-    onAddValue?: (option: ProductOptionGroup) => void;
+    /**
+     * Fired when a value is added. The overflow command passes the option alone,
+     * so the app opens its own form. A saved inline edit fires once per added
+     * value and passes that value, with its draft id and typed label.
+     */
+    onAddValue?: (option: ProductOptionGroup, value?: ProductOptionValue) => void;
     /** Fired when a value is removed. */
     onDeleteValue?: (option: ProductOptionGroup, value: ProductOptionValue) => void;
     onOptionNameChange?: (option: ProductOptionGroup, value: string) => void;
@@ -629,6 +633,13 @@ export interface ProductVariantsTableProps {
     footerSlot?: ReactNode;
     /** Shown in place of the collection when it has no entries. */
     empty?: ReactNode;
+    /**
+     * Key under which the column visibility is remembered (`dt.{storageKey}.columns`
+     * in localStorage). Every table sharing a key shares its hidden columns, so
+     * give each product context its own key. `false` turns persistence off.
+     * @default 'product-variants'
+     */
+    storageKey?: string | false;
     /** Merged onto the outermost node. */
     className?: string;
     /** Overrides this surface’s own copy. */
@@ -691,7 +702,12 @@ export interface ProductVariantsBulkTableProps {
     visibleColumns?: readonly ProductVariantsBulkTableColumn[];
     /** How each row's option combination is presented. */
     optionCombinationDisplay?: ProductVariantOptionCombinationDisplay;
-    /** Which editable fields each row exposes, and how. */
+    /**
+     * Which editable fields each row exposes, and how. A `field` cell edits a
+     * string or number value; a node value such as a formatted price renders an
+     * empty field. The cell is read-only until `onVariantFieldChange` or
+     * `onVariantFieldBlur` is supplied.
+     */
     cellDisplay?: ProductVariantCellDisplayConfig;
     /** Whether one variant or several can be selected at a time. */
     selectionMode?: ProductVariantSelectionMode;
@@ -701,7 +717,11 @@ export interface ProductVariantsBulkTableProps {
     renderCell?: (variant: ProductVariantRow, context: ProductVariantCellRenderContext) => ReactNode;
     /** Ids of the selected variants. Controlled. */
     selectedVariantIds?: string[];
-    /** Initially selected variant ids, for uncontrolled use. */
+    /**
+     * Initially selected variant ids, for uncontrolled use. An uncontrolled
+     * selection follows `variants`: an id whose row is removed leaves it. Control
+     * `selectedVariantIds` to keep a selection across filtering or paging.
+     */
     defaultSelectedVariantIds?: string[];
     onSelectedVariantIdsChange?: (variantIds: string[], variants: ProductVariantRow[]) => void;
     onVariantFieldChange?: (
@@ -753,7 +773,7 @@ export interface ProductVariantsBulkTableProps {
     /** Overrides this surface’s own copy. */
     strings?: StringsProp<ProductVariantBulkTableStrings>;
 }
-export interface ProductVariantsManagerProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider' | 'footerDivider'>, Pick<ProductOptionsMatrixProps, 'optionGroups' | 'collapsedOptionIds' | 'defaultCollapsedOptionIds' | 'onCollapsedOptionIdsChange' | 'editingOptionId' | 'defaultEditingOptionId' | 'onEditingOptionIdChange' | 'onCreateOption' | 'onEditOption' | 'onDeleteOption' | 'onAddValue' | 'onDeleteValue' | 'onOptionNameChange' | 'onValueLabelChange' | 'onDoneEditingOption' | 'onSaveEditingOption' | 'onError' | 'onCancelEditingOption' | 'onToggleUsedForVariants' | 'renderOptionActions' | 'renderValue'>, Pick<ProductVariantsBulkTableProps, 'variants' | 'groupByOptionId' | 'visibleColumns' | 'optionCombinationDisplay' | 'cellDisplay' | 'selectionMode' | 'renderOptionCombination' | 'renderCell' | 'selectedVariantIds' | 'defaultSelectedVariantIds' | 'onSelectedVariantIdsChange' | 'onVariantFieldChange' | 'onVariantFieldBlur' | 'onCreateVariant' | 'onGenerateVariants' | 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant' | 'onBulkEdit' | 'onBulkApply' | 'onBulkDelete' | 'renderVariantActions' | 'renderBulkActions'> {
+export interface ProductVariantsManagerProps extends Pick<CardProps, 'surface' | 'padding' | 'headerDivider' | 'footerDivider'>, Pick<ProductOptionsMatrixProps, 'optionGroups' | 'collapsedOptionIds' | 'defaultCollapsedOptionIds' | 'onCollapsedOptionIdsChange' | 'editingOptionId' | 'defaultEditingOptionId' | 'onEditingOptionIdChange' | 'onCreateOption' | 'onEditOption' | 'onDeleteOption' | 'confirmDelete' | 'onAddValue' | 'onDeleteValue' | 'onOptionNameChange' | 'onValueLabelChange' | 'onDoneEditingOption' | 'onSaveEditingOption' | 'onError' | 'onCancelEditingOption' | 'onToggleUsedForVariants' | 'renderOptionActions' | 'renderValue'>, Pick<ProductVariantsBulkTableProps, 'variants' | 'groupByOptionId' | 'visibleColumns' | 'optionCombinationDisplay' | 'cellDisplay' | 'selectionMode' | 'renderOptionCombination' | 'renderCell' | 'selectedVariantIds' | 'defaultSelectedVariantIds' | 'onSelectedVariantIdsChange' | 'onVariantFieldChange' | 'onVariantFieldBlur' | 'onCreateVariant' | 'onGenerateVariants' | 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant' | 'onBulkEdit' | 'onBulkApply' | 'onBulkDelete' | 'renderVariantActions' | 'renderBulkActions'> {
     /** Groups rows under the values of this option. `null` leaves the list flat. */
     groupByOptionId?: string | null;
     /** Option group used for grouping on first render. */
@@ -835,8 +855,6 @@ export interface ProductVariantOptionField {
     id: string;
     /** Display label. */
     label: string;
-    /** Fallback for an absent option value. @deprecated Set value.options or defaultValue.options on ProductVariantEditor. */
-    value?: string;
     choices?: ProductChoice[];
     placeholder?: string;
     helperText?: string;

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

@@ -83,10 +83,8 @@ 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`. */
+    /** Fired when navigation requests a question. */
     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. */
     onSubmit?: (answers: QuestionnaireAnswers, context: QuestionnaireSubmitContext) => void | Promise<void>;
@@ -95,7 +93,11 @@ export interface QuestionnaireProps extends Omit<ComponentPropsWithoutRef<'form'
     formatSubmitError?: (error: unknown) => string;
     headerSlot?: ReactNode;
     emptySlot?: ReactNode;
-    /** Replaces the completion state; default includes an edit-answers action. */
+    /**
+     * Replaces the completion state; default includes an edit-answers action.
+     * Either one renders inside a focusable `questionnaire--completion` region
+     * that receives focus when submission completes.
+     */
     completionSlot?: ReactNode;
     strings?: StringsProp<QuestionnaireStrings>;
 }

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

@@ -1,3 +1,2 @@
-export { ResourceActionBar, ResourceDetailsSection, ResourceEmptyState, ResourceHeader, ResourceIndexShell, ResourceShowShell, TabbedResourceShell, } from './resource';
-export type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderCommandProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShellSlots, ResourceShowShellProps, TabbedResourceShellProps, } from './resource.types';
-export { defaultResourceStrings, type ResourceStrings, } from './resource.strings';
+export { ResourceActionBar, ResourceDetailsSection, ResourceEmptyState, } from './resource';
+export type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, } from './resource.types';

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

@@ -1,12 +1,4 @@
-import type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShowShellProps, TabbedResourceShellProps } from './resource.types';
-/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
-export declare function ResourceHeader({ title, description, eyebrow, media, avatarUrl, avatarAlt, avatarFallback, icon, iconTone, badges, metadata, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, moreActionsLabel, renderLink, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
+import type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps } from './resource.types';
 export declare function ResourceActionBar({ children, leading, trailing, sticky, className }: ResourceActionBarProps): import("react").JSX.Element;
-export declare function ResourceEmptyState(props: ResourceEmptyStateProps): import("react").JSX.Element;
-/** @deprecated Use Page from themelia-react-ui/layout/page; PageHeader is available for embedded headers. */
-export declare function ResourceIndexShell(props: ResourceIndexShellProps): import("react").JSX.Element;
-/** @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, defaultActiveTab, onTabChange, tabsClassName, moreLabel, tabsAriaLabel, toolbar, slots, className, strings: stringsProp, ...props }: TabbedResourceShellProps): import("react").JSX.Element;
+export declare function ResourceEmptyState({ 'aria-label': ariaLabel, ...props }: ResourceEmptyStateProps): 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

@@ -1,139 +1,12 @@
-import type { ComponentType, ReactNode } from 'react';
-import type { IconBadgeTone } from '../../base/display';
+import type { ReactNode } from 'react';
 import type { MetadataListItem } from '../../base/metadata-list';
 import type { EmptyStateProps } from '../../blocks/data-display';
 import type { ActionMenuAction } from '../../base/action-menu';
-import type { OverflowTabItem, PageHeaderAction, PageHeaderLinkRenderer } from '../../base/navigation';
-import type { StringsProp } from '../../../lib/strings';
 import type { CardSurface, ComponentScale } from '../../../lib/component-vocabulary';
-import type { ResourceStrings } from './resource.strings';
 /** Structural padding preset for resource content blocks. */
 export type ResourceBlockPadding = ComponentScale;
 /** Chrome treatment for resource content blocks. */
 export type ResourceBlockSurface = CardSurface;
-export interface ResourceShellSlots {
-    /** Replaces the generated identity header. */
-    header?: ReactNode;
-    /** Replaces the toolbar region, including the default tab toolbar. */
-    toolbar?: ReactNode;
-    /** Related context rendered beside the primary column when the container is wide enough. */
-    aside?: ReactNode;
-    /** Content rendered after the primary workspace body. */
-    footer?: ReactNode;
-    /** Replaces the default loading panel. */
-    loading?: ReactNode;
-    /** Replaces the default empty state. */
-    empty?: ReactNode;
-    /** Replaces the default error state. */
-    error?: ReactNode;
-}
-/**
- * Role-based header commands, placed and styled exactly as in Page headers:
- * outline secondary commands, the solid primary command, then the More actions
- * menu.
- */
-export interface ResourceHeaderCommandProps {
-    /** The resource's one main command: a solid primary button, in the command menu in compact headers. */
-    primaryAction?: PageHeaderAction;
-    /**
-     * Supporting commands in priority order. The first two render as outline
-     * buttons before the primary command; the rest, and every destructive
-     * command, move into the More actions menu, which always closes the row.
-     */
-    secondaryActions?: readonly PageHeaderAction[];
-    /**
-     * How many routine secondary commands render as outline buttons on wide
-     * headers; later ones join the More actions menu. Use `1` or `0` when long
-     * labels beside the primary command would crowd the header; `Infinity`
-     * keeps every routine command inline. @default 2
-     */
-    maxVisibleSecondaryActions?: number;
-    /** Accessible name of the More actions menu trigger. Default: `'More actions'`. */
-    moreActionsLabel?: string;
-    /** Renders `href` commands as framework links. Defaults to a native anchor. */
-    renderLink?: PageHeaderLinkRenderer;
-}
-/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
-export interface ResourceIndexShellProps extends ResourceHeaderCommandProps {
-    /** Primary workspace content. Replaced by loading, error, or empty state when active. */
-    children?: ReactNode;
-    /** Generated header title. Omit when supplying `slots.header`. */
-    title?: ReactNode;
-    /** Generated header description. */
-    description?: ReactNode;
-    /**
-     * Non-command controls in the generated header, such as a period select.
-     * They render before the role-based commands; pass commands as
-     * `primaryAction` and `secondaryActions`.
-     */
-    actions?: ReactNode;
-    /** Content between the header and primary workspace body. */
-    toolbar?: ReactNode;
-    /** Empty-state override. Prefer `slots.empty` when configuring several regions together. */
-    emptySlot?: ReactNode;
-    /** Replaces the primary content with the empty state. */
-    empty?: boolean;
-    /** Replaces the primary content with the loading panel. */
-    loading?: boolean;
-    /** Error content, value, or Error object. Truthy values replace the primary content. */
-    error?: ReactNode | Error;
-    /** Retry callback used by the default error state. */
-    onRetry?: () => void;
-    /** Replaceable workspace regions for consumer-owned composition. */
-    slots?: ResourceShellSlots;
-    /** Class name for the outer named container. */
-    className?: string;
-    /** Class name for the generated header. */
-    headerClassName?: string;
-    /** Class name for the primary body region. */
-    contentClassName?: string;
-    /** Copy overrides for loading, empty, error, retry, and tab labels. */
-    strings?: StringsProp<ResourceStrings>;
-}
-/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
-export interface ResourceShowShellProps extends ResourceIndexShellProps {
-    /** Class name for `slots.aside`. */
-    asideClassName?: string;
-}
-/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
-export interface ResourceHeaderProps extends ResourceHeaderCommandProps {
-    /** Primary resource identity. */
-    title: ReactNode;
-    /** Supporting resource summary. */
-    description?: ReactNode;
-    /** Quiet context rendered above the title. */
-    eyebrow?: ReactNode;
-    /** Full media override. Takes precedence over avatar and icon props. */
-    media?: ReactNode;
-    /** Avatar image URL used when `media` is omitted. */
-    avatarUrl?: string;
-    /** Accessible alternative text for the avatar image. */
-    avatarAlt?: string;
-    /** Avatar fallback. Defaults to initials derived from a string title. */
-    avatarFallback?: ReactNode;
-    /** Icon rendered in an IconBadge when no media or avatar is supplied. */
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    /** Semantic tone for the generated IconBadge. */
-    iconTone?: IconBadgeTone;
-    /** Status or identity badges rendered beside the title. */
-    badges?: ReactNode;
-    /** Compact resource facts rendered below the description. */
-    metadata?: ReactNode;
-    /**
-     * Non-command controls, such as a period select. They render before the
-     * role-based commands; pass commands as `primaryAction` and
-     * `secondaryActions`.
-     */
-    actions?: ReactNode;
-    /** Class name for the page-header root. */
-    className?: string;
-    /** Class name for the page-header content region. */
-    contentClassName?: string;
-    /** Class name for generated avatar or icon media. */
-    mediaClassName?: string;
-}
 export interface ResourceActionBarProps {
     /** Default leading content when `leading` is omitted. */
     children?: ReactNode;
@@ -146,14 +19,16 @@ export interface ResourceActionBarProps {
     /** Class name for the action-bar root. */
     className?: string;
 }
-export interface ResourceEmptyStateProps extends EmptyStateProps {
+export interface ResourceEmptyStateProps extends Omit<EmptyStateProps, 'ariaLabel'> {
+    /** Accessible name of the empty region. Defaults to the empty-state `strings.ariaLabel`. */
+    'aria-label'?: string;
 }
 interface ResourceSectionFrameProps {
     /** Block title. */
     title?: ReactNode;
     /** Supporting block description. */
     description?: ReactNode;
-    /** Overflow actions rendered by ContentBlock. */
+    /** Overflow actions rendered in the block header's menu. */
     actions?: ActionMenuAction[];
     /** Custom action rendered directly in the header. */
     headerAction?: ReactNode;
@@ -161,8 +36,8 @@ interface ResourceSectionFrameProps {
     children?: ReactNode;
     /** Footer content rendered after the body. */
     footer?: ReactNode;
-    /** Structural padding preset. */
-    padding?: ResourceBlockPadding;
+    /** Structural padding preset. `none` composes the block inside an existing boundary, with `surface="flat"`. */
+    padding?: ResourceBlockPadding | 'none';
     /** Surface chrome. Use `flat` when embedding inside an existing frame. */
     surface?: ResourceBlockSurface;
     /** Class name for the block root. */
@@ -182,21 +57,4 @@ export interface ResourceDetailsSectionProps extends ResourceSectionFrameProps {
     /** Quiet guidance rendered after the section content. */
     help?: ReactNode;
 }
-/** @deprecated Use PageProps or PageHeaderProps from themelia-react-ui/layout/page. */
-export interface TabbedResourceShellProps extends ResourceShowShellProps {
-    /** Workspace tabs, including optional overflow metadata. */
-    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. */
-    tabsClassName?: string;
-    /** Label for the overflow-tabs trigger. */
-    moreLabel?: string;
-    /** Accessible label for the tab list. */
-    tabsAriaLabel?: string;
-}
 export {};

package/dist/components/features/resource-assignment/partials/assignment-surface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The assignment card used to render through the deprecated ContentBlock
+ * adapter and now composes Card directly. It keeps the DOM hooks that adapter
+ * painted, so consumer selectors written against them still match.
+ */
+export declare function assignmentBlockProps(className?: string, contentClassName?: string): {
+    readonly surface: "flat";
+    readonly padding: "none";
+    readonly 'data-component': "content-block";
+    readonly 'data-slot': "content-block";
+    readonly className: string;
+    readonly headerClassName: "content-block--header";
+    readonly contentClassName: string;
+    readonly footerClassName: "content-block--footer";
+};

package/dist/components/features/resource-assignment/resource-assignment.strings.d.ts

@@ -12,6 +12,11 @@ export interface SharedResourceCardStrings {
     currentlySelected: string;
     noResourceContent: string;
     noResourceSelected: string;
-    changeAction: string;
+    /** Empty-state action that opens the selector for a first assignment. */
+    assignAction?: string;
+    /** Accessible name of the selector dialog's corner dismiss control. */
+    closeLabel?: string;
+    /** Shown in the selector dialog when confirmation rejects without a message. */
+    confirmErrorMessage?: string;
 }
 export declare const defaultSharedResourceCardStrings: SharedResourceCardStrings;

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

@@ -26,6 +26,12 @@ export type SharedResourceCardContext<TResource, TSuggestion> = {
     isSelectorOpen: boolean;
     /** Whether async confirmation is pending. */
     isConfirming: boolean;
+    /**
+     * What the last rejected confirmation threw, or `null`. Cleared when the
+     * candidate changes, the selector closes or confirmation is retried. The
+     * default dialog shows it; a custom dialog body can read it here.
+     */
+    confirmError?: unknown;
     /** Candidate selection that has not yet been persisted. */
     selectedSuggestion: TSuggestion | null;
     /** Update the pending candidate selection. */

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

@@ -18,11 +18,9 @@ import type { RichTextCaretContext, TiptapEditor } from '../rich-text-editor.typ
  */
 export declare function readCaretContext(): RichTextCaretContext | null;
 /**
- * Extend the selection backwards by `length` characters, then insert
- * `html`. The selection extension means `editor.insertContent` (or the
- * fallback's `range.deleteContents()` + insert) replaces the trigger
- * range with the chip atomically — no manual text-content mutation, no
- * timing races between "delete" and "insert".
+ * Replace the `length` characters before the caret with `html`. ProseMirror
+ * owns its selection, so the run is replaced in document positions inside the
+ * caret's text block: the trigger text and the chip swap in one transaction,
+ * and the editor reports the normalized value through its update.
  */
-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;
+export declare function replaceBeforeCaret(editor: TiptapEditor, length: number, html: string): void;

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

@@ -1,7 +1,6 @@
 /**
- * Plain HTML normalization shared by the TipTap and contenteditable
- * fallback editors. Keeping these out of the React tree means the
- * editor partials stay focused on rendering.
+ * Plain HTML normalization for the editor. Keeping these out of the React
+ * tree means the editor partials stay focused on rendering.
  */
 export declare function normalizeHtml(value: string): string;
 export declare function toEditorContent(value: string): string;

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

@@ -45,10 +45,12 @@ export declare function useImageUploadQueue(images: RichTextEditorImages | undef
 };
 export type ImageUploadQueue = ReturnType<typeof useImageUploadQueue>;
 /** Renders each pending upload's status into its placeholder in the editing surface. */
-export declare function ImageUploadPortals({ queue, adapterRef, strings }: {
+export declare function ImageUploadPortals({ queue, adapterRef, strings, disabled }: {
     queue: ImageUploadQueue;
     adapterRef: RefObject<ImageUploadAdapter | null>;
     strings: RichTextEditorStrings['images'];
+    /** A disabled editor keeps its pending uploads but offers no way to change them. */
+    disabled?: boolean;
 }): import("react").JSX.Element;
 /** The Insert image toolbar control and its hidden file input. */
 export declare function useImageInsertControl(images: RichTextEditorImages | undefined, strings: RichTextEditorStrings['images'], onFiles: (files: File[]) => void, beforeOpen?: () => void): {
@@ -56,10 +58,12 @@ export declare function useImageInsertControl(images: RichTextEditorImages | und
     input: import("react").JSX.Element | null;
 };
 /** The description field for the image at the caret, and refused-file notices. */
-export declare function ImageDetailsBar({ alt, onAltChange, onRemove, notice, onDismissNotice, strings }: {
+export declare function ImageDetailsBar({ alt, onAltChange, onRemove, notice, onDismissNotice, strings, disabled }: {
     alt: string | null;
     onAltChange: (alt: string) => void;
     onRemove: () => void;
+    /** A disabled editor shows the description but does not let it, or the image, change. */
+    disabled?: boolean;
     notice: string | null;
     onDismissNotice: () => void;
     strings: RichTextEditorStrings['images'];

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

@@ -1,7 +1,6 @@
 export { RichTextEditorToolbar, type RichTextEditorToolbarProps, } from './rich-text-editor-toolbar';
-export { TiptapRichTextEditor, hasTiptapRuntime } from './rich-text-editor-tiptap';
-export { FallbackRichTextEditor } from './rich-text-editor-fallback';
+export { TiptapRichTextEditor } from './rich-text-editor-tiptap';
 export { CountsFooter, CountsFooterText } from './counts-footer';
 export type { CountsFooterProps, CountsFooterTextProps } from './counts-footer';
-export { readCaretContext, replaceBeforeCaret, insertHtmlIntoEditable, } from './caret-helpers';
+export { readCaretContext, replaceBeforeCaret, } from './caret-helpers';
 export { normalizeHtml, toEditorContent } from './html-helpers';

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

@@ -1,3 +1,2 @@
 import type { RichTextEditorHandle, RichTextEditorProps } from '../rich-text-editor.types';
 export declare const TiptapRichTextEditor: import("react").ForwardRefExoticComponent<RichTextEditorProps & import("react").RefAttributes<RichTextEditorHandle>>;
-export declare const hasTiptapRuntime: boolean;

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

@@ -17,9 +17,8 @@ export interface RichTextEditorToolbarProps {
     /** Renders the entry as unselectable. */
     disabled?: boolean;
     /**
-     * The TipTap variant disables built-in buttons until the editor instance
-     * is ready; the fallback variant simply marks them disabled. This flag
-     * lets callers force the disabled state without re-deriving it per button.
+     * Built-in buttons stay disabled until the editor instance is ready. This
+     * flag lets callers force the disabled state without re-deriving it per button.
      */
     hasEditor?: boolean;
     /** Content pinned to the end of the toolbar. */

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

@@ -28,6 +28,11 @@ export interface RichTextCaretContext {
 export interface RichTextEditorHandle {
     focus(): void;
     getHTML(): string;
+    /**
+     * Replaces the document and reports it through `onValueChange`. Called from
+     * inside `onValueChange` with the current `value`, it rejects the reported
+     * change: the document is restored and nothing further is reported.
+     */
     setHTML(html: string): void;
     /** Inserts raw HTML at the current selection. */
     insertHTML(html: string): void;
@@ -96,7 +101,14 @@ export interface RichTextEditorImages extends RichTextImageRendering {
 /** Body floor roles for the rich text editor. */
 export type RichTextEditorBodyHeight = 'control' | 'field' | 'document';
 export interface RichTextEditorProps extends FieldControlAttributes {
-    /** Editor content as HTML. Controlled. */
+    /**
+     * Editor content as HTML. Value-synchronised: the editor owns the document
+     * while the user edits and reports each change through `onValueChange`; a
+     * new `value` replaces the document. Keeping the same `value` after a
+     * reported change leaves the edit in place. To reject or substitute a
+     * change, either set `value` to the replacement (a different string) or
+     * call `setHTML` on the handle.
+     */
     value: string;
     /** Reports the document HTML. Source edits commit when switching back to rich text. */
     onValueChange: (html: string) => void;

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

@@ -23,5 +23,10 @@ export interface UseSchemaFormResult extends SchemaFormSubmitHelpers {
     setFieldParseValidity: (key: string, valid: boolean) => void;
     reset: () => SchemaFormValues;
     validate: () => boolean;
+    /**
+     * Keys the latest `validate()` call rejected, in schema order. Includes
+     * JSON fields whose draft cannot be parsed; empty after a passing run.
+     */
+    getInvalidKeys: () => string[];
 }
 export declare function useSchemaForm(options: UseSchemaFormOptions): UseSchemaFormResult;

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

@@ -1,5 +1,5 @@
 import type { SchemaFormProps } from './schema-form.types';
-export declare function SchemaForm({ schema, value, defaultValue, errors, disabled, layout, columns, id, name, title, description, headerSlot, footerSlot, actionsSlot, emptySlot, showActions, submitLabel, resetLabel, submitDisabled, resetDisabled, submitting, onValueChange, onFieldChange, onSubmit, onReset, onError, renderField, renderSection, strings: stringsProp, className, contentClassName, sectionClassName, fieldClassName, }: SchemaFormProps): import("react").JSX.Element;
+export declare function SchemaForm({ schema, value, defaultValue, errors, disabled, layout, columns, id, name, title, description, headerSlot, footerSlot, actionsSlot, emptySlot, showActions, submitDisabled, resetDisabled, submitting, hiddenValues, onValueChange, onFieldChange, onSubmit, onReset, onError, renderField, renderSection, strings: stringsProp, className, contentClassName, sectionClassName, fieldClassName, }: SchemaFormProps): import("react").JSX.Element;
 export declare namespace SchemaForm {
     var displayName: string;
 }

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

@@ -235,16 +235,24 @@ export interface SchemaFormProps {
     emptySlot?: ReactNode;
     /** Renders the actions. */
     showActions?: boolean;
-    /** Copy for the submit button. */
-    submitLabel?: string;
-    /** Copy for the reset button. */
-    resetLabel?: string;
     /** Disables the submit button. */
     submitDisabled?: boolean;
     /** Disables the reset button. */
     resetDisabled?: boolean;
-    /** Shows the pending state on submit and blocks repeat presses. */
+    /**
+     * Shows the pending state on submit and blocks repeat presses. Left
+     * unset, the form shows it while a promise returned by `onSubmit` is
+     * pending. A second submission is ignored until that promise settles
+     * whether or not this prop is set.
+     */
     submitting?: boolean;
+    /**
+     * What `onSubmit` receives for fields whose `hidden` rule currently
+     * applies. `keep` (default) submits every stored value; `omit` leaves
+     * hidden fields out of the payload while keeping their values in form
+     * state, so showing the field again restores what was entered.
+     */
+    hiddenValues?: 'keep' | 'omit';
     onValueChange?: (values: SchemaFormValues) => void;
     onFieldChange?: (key: string, value: SchemaFormValue, values: SchemaFormValues) => void;
     /** Fired when an entry is submitted. */

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

@@ -12,5 +12,19 @@ export interface SuggestionsStrings {
     startTypingMessage: string;
     errorMessage: string;
     retry: string;
+    /**
+     * Hint shown while the query is shorter than `minQueryLength`. `{remaining}`
+     * is replaced by the number of characters still needed and `{s}` by an
+     * English plural suffix; use `formatTypeMore` for other plural rules.
+     */
+    typeMoreMessage?: string;
+    /** Builds the remaining-characters hint from the count. Wins over `typeMoreMessage`. */
+    formatTypeMore?: (remaining: number) => string;
+    /** Accessible name of the control that clears the selection. */
+    clear?: string;
+    /** Accessible name of the control that opens the list. */
+    toggle?: string;
+    /** Accessible name of the screen-reader dismissal controls inside the list. */
+    dismiss?: string;
 }
 export declare const defaultSuggestionsStrings: SuggestionsStrings;

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

@@ -9,13 +9,17 @@ export interface SuggestionsFetchContext {
 export interface UseSuggestionsConfig<T> {
     /** Loads suggestions for a query. Receives an `AbortSignal` for the superseded request. */
     fetchData: (query: string, context?: SuggestionsFetchContext) => MaybePromise<T[]>;
-    /** Characters required before a request is issued. Default: `1`. */
+    /** Characters required before a request is issued, counted without surrounding whitespace. Default: `1`. */
     minQueryLength?: number;
-    /** Quiet period before a request is scheduled, in milliseconds. Default: `250`. */
+    /** Quiet period before a request is scheduled, in milliseconds. Default: `300`, the library-wide debounce. */
     debounceMs?: number;
     /** Extra wait before `fetchData` runs, applied once the loading state is already visible. Default: `0`. */
     requestDelay?: number;
-    /** Issues a request for the empty query so suggestions exist before typing. */
+    /**
+     * Issues a request for the empty query so suggestions exist before typing.
+     * `SuggestionsCombobox` lists them when the empty field is opened, whatever
+     * `minQueryLength` is.
+     */
     preload?: boolean;
     /** Controlled query. */
     query?: string;
@@ -38,7 +42,11 @@ export interface UseSuggestionsConfig<T> {
 }
 export interface UseSuggestionsResult<T> {
     items: T[];
-    /** Replaces the content with the loading state. */
+    /**
+     * Replaces the content with the loading state. True from the moment the
+     * query changes, so the previous query's items are never offered while the
+     * next request is still debounced.
+     */
     isLoading: boolean;
     error: unknown | null;
     isError: 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, 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 function DataTable<TData extends object, TValue = unknown>({ size, surface, headerTransparent, columns, data, loading, loadingRows, columnGroups, rowActions, rowActionsMenuLabel, rowActionsDisplayMode, rowActionsBreakpoint, enableSorting, enableResizing, filterColumn, manualSorting, enableColumnVisibility, fullscreen: controlledFullscreen, defaultFullscreen, onFullscreenChange, showFullscreenToggle, enableRowSelection, enableMultiRowSelection, pagination, pageQueryKey, onPageChange, onSortingChange, onColumnFiltersChange, onRowClick, onRowSelectionChange, stickyHeader, stickyToolbar, stickyFirstColumn, maxBodyHeight, fillAvailableHeight, emptyStateAction, className, rowClassName, cellClassName, headerClassName, wrapperClassName, innerClassName, tableContainerClassName, getRowId, rowSelection: controlledRowSelection, sorting: controlledSorting, columnVisibility: controlledColumnVisibility, initialState, onColumnVisibilityChange, strings: stringsOverride, topbarContent, topbarEnd, topbarClassName, toolbarLabelVisibility, footerContent, selectionToolbar, bulkActions, selectionToolbarClassName, selectionToolbarPlacement, totalRowCount: totalRowCountProp, storageKey, columnVisibilityPrecedence, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
 export declare namespace DataTable {
     var displayName: string;
 }

package/dist/components/features/table/filter-bar.d.ts

@@ -1,5 +1,5 @@
 import { type DataTableFilterBarProps } from './table.types';
-export declare function DataTableFilterBar<TData>({ table, filterColumn, filterPlaceholder, enableColumnVisibility, customContent, strings, }: DataTableFilterBarProps<TData>): import("react").JSX.Element | null;
+export declare function DataTableFilterBar<TData>({ table, filterColumn, enableColumnVisibility, customContent, strings, }: DataTableFilterBarProps<TData>): import("react").JSX.Element | null;
 export declare namespace DataTableFilterBar {
     var displayName: string;
 }

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

@@ -1,5 +1,5 @@
 import { type ServerPaginationProps } from './table.types';
-export declare function Pagination({ pagination, onPageChange, labels, pageQueryKey, }: ServerPaginationProps): import("react").JSX.Element;
+export declare function Pagination({ pagination, onPageChange, labels, pageQueryKey, className, }: ServerPaginationProps): import("react").JSX.Element;
 export declare namespace Pagination {
     var displayName: string;
 }

package/dist/components/features/table/partials/cell-value.d.ts

@@ -63,7 +63,7 @@ export interface CellValueProps extends Omit<CellValueDescriptor, 'className' |
     value?: PrimitiveCellValue;
     /** Which primitive should render the value. Defaults to Value. */
     kind?: CellValueKind;
-    /** Text shown when value is missing. Defaults to '--'. */
+    /** Text shown when value is missing. Defaults to an em dash. */
     fallback?: ReactNode;
     /** Force missing state regardless of value emptiness. */
     missing?: boolean;