themelia-react-ui 2.0.5 → 3.0.0

package/dist/components/features/products/components/product-option-action-menu.d.ts

@@ -2,7 +2,7 @@ import type { ProductOptionActionMenuProps } from '../products.types';
 /**
  * Row menu for one product option.
  *
- * @deprecated An internal part of `ProductOptionsSummary` (and so of `ProductOverview`), which renders it for every option. Replace it there with `renderOptionActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.
+ * Internal part of the option and variant surfaces; not exported from the family.
  */
 export declare function ProductOptionActionMenu({ option, index, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, menuLabel, className, strings: stringsProp, }: ProductOptionActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductOptionActionMenu {

package/dist/components/features/products/components/product-options-summary.d.ts

@@ -2,7 +2,7 @@ import type { ProductOptionsSummaryProps } from '../products.types';
 /**
  * One main column region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `options` prop (still typed `ProductOptionsSummaryProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductOptionsSummary({ options, onManageOptions, onCreateOption, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, actions, footerSlot, renderOption, empty, className, strings: stringsProp, }: ProductOptionsSummaryProps): import("react").JSX.Element;
 export declare namespace ProductOptionsSummary {

package/dist/components/features/products/components/product-policies-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductPoliciesCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `policies` prop (still typed `ProductPoliciesCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductPoliciesCard({ policies, onCreatePolicy, onSelectPolicy, onEditPolicy, onDeletePolicy, renderPolicyActions, actions, footerSlot, renderPolicy, empty, className, strings: stringsProp, }: ProductPoliciesCardProps): import("react").JSX.Element;
 export declare namespace ProductPoliciesCard {

package/dist/components/features/products/components/product-quote-preview-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductQuotePreviewCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `quote` prop (still typed `ProductQuotePreviewCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductQuotePreviewCard({ lines, subtotal, tax, discount, total, onOpenQuote, onCreateLine, onSelectLine, onEditLine, onDeleteLine, renderLineActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductQuotePreviewCardProps): import("react").JSX.Element;
 export declare namespace ProductQuotePreviewCard {

package/dist/components/features/products/components/product-readiness-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductReadinessCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `readiness` prop (still typed `ProductReadinessCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductReadinessCard({ items, score, scoreLabel, summary, onCreateReadinessItem, onSelectReadinessItem, onEditReadinessItem, onDeleteReadinessItem, renderReadinessItemActions, actions, footerSlot, renderItem, empty, className, strings: stringsProp, }: ProductReadinessCardProps): import("react").JSX.Element;
 export declare namespace ProductReadinessCard {

package/dist/components/features/products/components/product-structure-card.d.ts

@@ -2,7 +2,7 @@ import type { ProductStructureCardProps } from '../products.types';
 /**
  * One support rail region of the product editor.
  *
- * @deprecated An internal region of `ProductOverview`, which renders it from its `structure` prop (still typed `ProductStructureCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ * Internal region of `ProductOverview`; not exported from the family.
  */
 export declare function ProductStructureCard({ metrics, onCreateMetric, onSelectMetric, onEditMetric, onDeleteMetric, renderMetricActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductStructureCardProps): import("react").JSX.Element;
 export declare namespace ProductStructureCard {

package/dist/components/features/products/components/product-variant-action-menu.d.ts

@@ -18,7 +18,7 @@ export declare function productVariantMenuActions(variant: ProductVariantSummary
 /**
  * Row menu for one product variant.
  *
- * @deprecated An internal part of the variant tables and `ProductVariantDetails`, which render it for every variant. Replace it there with `renderVariantActions`, composing the base `ActionMenu` if needed. Kept exported for compatibility.
+ * Internal part of the option and variant surfaces; not exported from the family.
  */
 export declare function ProductVariantActionMenu({ variant, index, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, menuLabel, className, strings: stringsProp, }: ProductVariantActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductVariantActionMenu {

package/dist/components/features/products/components/product-variants-manager.d.ts

@@ -1,5 +1,5 @@
 import type { ProductVariantsManagerProps } from '../products.types';
-export declare function ProductVariantsManager({ optionGroups, variants, visibleColumns, optionCombinationDisplay, cellDisplay, selectionMode, renderOptionCombination, renderCell, selectedVariantIds, defaultSelectedVariantIds, onSelectedVariantIdsChange, onVariantFieldChange, onVariantFieldBlur, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onError, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onBulkEdit, onBulkApply, onBulkDelete, renderVariantActions, renderBulkActions, groupByOptionId, defaultGroupByOptionId, onGroupByOptionIdChange, showGroupBy, onSearchVariants, onFilterVariants, controlsEnd, actions, headerEnd, footerSlot, surface, padding, headerDivider, footerDivider, className, strings: stringsProp, optionsStrings, variantsStrings, }: ProductVariantsManagerProps): import("react").JSX.Element;
+export declare function ProductVariantsManager({ optionGroups, variants, visibleColumns, optionCombinationDisplay, cellDisplay, selectionMode, renderOptionCombination, renderCell, selectedVariantIds, defaultSelectedVariantIds, onSelectedVariantIdsChange, onVariantFieldChange, onVariantFieldBlur, collapsedOptionIds, defaultCollapsedOptionIds, onCollapsedOptionIdsChange, editingOptionId, defaultEditingOptionId, onEditingOptionIdChange, onCreateOption, onEditOption, onDeleteOption, confirmDelete, onAddValue, onDeleteValue, onOptionNameChange, onValueLabelChange, onDoneEditingOption, onSaveEditingOption, onError, onCancelEditingOption, onToggleUsedForVariants, renderOptionActions, renderValue, onCreateVariant, onGenerateVariants, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, onBulkEdit, onBulkApply, onBulkDelete, renderVariantActions, renderBulkActions, groupByOptionId, defaultGroupByOptionId, onGroupByOptionIdChange, showGroupBy, onSearchVariants, onFilterVariants, controlsEnd, actions, headerEnd, footerSlot, surface, padding, headerDivider, footerDivider, className, strings: stringsProp, optionsStrings, variantsStrings, }: ProductVariantsManagerProps): import("react").JSX.Element;
 export declare namespace ProductVariantsManager {
     var displayName: string;
 }

package/dist/components/features/products/components/product-variants-table.d.ts

@@ -1,5 +1,5 @@
 import type { ProductVariantsTableProps } from '../products.types';
-export declare function ProductVariantsTable({ variants, onCreateVariant, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductVariantsTableProps): import("react").JSX.Element;
+export declare function ProductVariantsTable({ variants, onCreateVariant, onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant, renderVariantActions, actions, footerSlot, empty, storageKey, className, strings: stringsProp, }: ProductVariantsTableProps): import("react").JSX.Element;
 export declare namespace ProductVariantsTable {
     var displayName: string;
 }

package/dist/components/features/products/partials/product-surface.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Product surfaces used to render through the deprecated ContentBlock adapter
+ * and now compose Card directly. They keep the DOM hooks that adapter painted,
+ * so consumer selectors written against them still match.
+ */
+export declare function productBlockProps(className?: 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: "content-block--content";
+    readonly footerClassName: "content-block--footer";
+};

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

@@ -132,7 +132,11 @@ export interface ProductOptionsMatrixStrings {
     collapseOptionLabel: string;
     actionsLabel: string;
     optionNameLabel: string;
+    /** Shown under the option name when a save is attempted with a blank name. */
+    optionNameRequiredMessage?: string;
     optionValuesLabel: string;
+    /** Shown under a value when a save is attempted with a blank label. */
+    optionValueRequiredMessage?: string;
     valuesLabel: string;
     useForVariantsLabel: string;
     usedForVariantsLabel: string;
@@ -238,6 +242,8 @@ export interface ProductVariantsManagerStrings {
     optionsTitle: string;
     variantsTitle: string;
     groupByLabel: string;
+    /** Group by choice that leaves the variant list flat. */
+    noGroupingLabel?: string;
     searchLabel: string;
     filterLabel: string;
     generateLabel: string;
@@ -265,6 +271,8 @@ export interface ProductVariantDetailsStrings {
     viewOptionLabel: string;
     emptyTitle: string;
     emptyDescription: string;
+    /** Labels of the variant commands in the header's overflow menu. Omitted keys keep the action-menu defaults. */
+    variantActions?: Partial<ProductVariantActionMenuStrings>;
     /** Label/value facts rendered as a metadata list. */
     metadata: {
         price: string;

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;
@@ -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;
-    /** Value shown beside the label. */
-    value?: string;
     choices?: ProductChoice[];
     placeholder?: string;
     helperText?: string;

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

@@ -83,7 +83,8 @@ export interface QuestionnaireProps extends Omit<ComponentPropsWithoutRef<'form'
     /** Controlled active question key. */
     questionId?: string;
     defaultQuestionId?: string;
-    onQuestionChange?: (id: string) => void;
+    /** Fired when navigation requests a question. */
+    onQuestionIdChange?: (id: string) => void;
     disabled?: boolean;
     /** Receives only visible, enabled questions. Respect signal to cancel application requests. */
     onSubmit?: (answers: QuestionnaireAnswers, context: QuestionnaireSubmitContext) => void | Promise<void>;
@@ -92,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, 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,19 +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;
-    /** 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/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

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