themelia-react-ui 2.0.0 → 2.0.1

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

@@ -1,6 +1,7 @@
 import type { ReactNode, RefObject, CSSProperties } from 'react';
 import type { ButtonStyle } from '../../base/buttons';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
+import type { OverlayAlign } from '../../../lib/ui-provider/types';
 import type { StringsProp } from '../../../lib/strings';
 import type { OverlayStrings } from './overlays.strings';
 export type OverlayTone = Extract<SemanticTone, 'neutral' | 'destructive' | 'warning' | 'info' | 'success'>;
@@ -8,6 +9,13 @@ export type OverlayButtonTone = SemanticTone;
 export type OverlayButtonStyle = Exclude<ButtonStyle, 'ghost'>;
 export type OverlaySize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | 'full';
 export type DrawerDirection = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Where the heading (tone icon, title, description) and the actions sit:
+ * `'start'` on the reading edge, `'center'` stacked on the dialog's centre line.
+ * Resolved from the explicit prop, then the provider's `overlay` slice, then the
+ * component's fallback.
+ */
+export type { OverlayAlign };
 /** Presentation and lifecycle shared by every overlay in this family. */
 export interface OverlayBaseProps {
     /** Visibility, for controlled use. Omit to let the overlay own it via `trigger`. */
@@ -129,6 +137,12 @@ export interface OverlayEmphasisProps {
 }
 /** A modal dialog with a title, body, and generated action footer. */
 export interface ActionDialogProps extends OverlayBaseProps, OverlayActionProps, OverlayEmphasisProps {
+    /**
+     * Aligns the heading and the actions. `'center'` stacks the `showIcon` glyph
+     * above the title. Default: the provider's `overlay.defaultDialogAlign`, else
+     * `'start'`.
+     */
+    align?: OverlayAlign;
     /** Maximum dialog width from the `sm` breakpoint; below it the dialog keeps a 1rem viewport margin. Default: `lg`. */
     size?: OverlaySize;
     /** Element that opens the dialog. Supply it for uncontrolled use instead of `open`; a string renders a secondary button. */
@@ -173,6 +187,12 @@ export interface ActionDrawerProps extends OverlayBaseProps, OverlayActionProps,
  * body needs real content — this one is sized for a question and two answers.
  */
 export interface ConfirmDialogProps extends OverlayBaseProps, OverlayActionProps {
+    /**
+     * Aligns the icon, title, description and actions together. Below the `sm`
+     * breakpoint the actions stack full width either way. Default: the
+     * provider's `overlay.defaultConfirmAlign`, else `'center'`.
+     */
+    align?: OverlayAlign;
     /** Semantic tone, driving the confirm button, the `showIcon` glyph and the notice. Default: `'neutral'`. */
     tone?: OverlayTone;
     /** Shows the tone's glyph above the title. Default: `false`; the confirm button and copy carry the tone. */

package/dist/components/features/products/components/product-contract-overview.d.ts

@@ -1,4 +1,9 @@
 import type { ProductContractOverviewProps } from '../products.types';
+/**
+ * One main column region of the product editor.
+ *
+ * @deprecated An internal region of `ProductOverview`, which renders it from its `contract` prop (still typed `ProductContractOverviewProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ */
 export declare function ProductContractOverview({ metrics, terms, rules, onOpenContract, onEditContract, onCreateRule, onSelectRule, onEditRule, onDeleteRule, renderRuleActions, actions, footerSlot, empty, className, strings: stringsProp, }: ProductContractOverviewProps): import("react").JSX.Element;
 export declare namespace ProductContractOverview {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 import type { ProductDetailsCardProps } from '../products.types';
+/**
+ * One main column region of the product editor.
+ *
+ * @deprecated An internal region of `ProductOverview`, which renders it from its `details` prop (still typed `ProductDetailsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ */
 export declare function ProductDetailsCard({ title, description, metadata, media, onEditDetails, actions, headerEnd, footerSlot, empty, className, strings: stringsProp, }: ProductDetailsCardProps): import("react").JSX.Element;
 export declare namespace ProductDetailsCard {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 import type { ProductOperationsCardProps } from '../products.types';
+/**
+ * One support rail region of the product editor.
+ *
+ * @deprecated An internal region of `ProductOverview`, which renders it from its `operations` prop (still typed `ProductOperationsCardProps`). Pass the same props there and add custom content through the overview's slots. Kept exported for compatibility.
+ */
 export declare function ProductOperationsCard({ items, onCreateOperation, onSelectOperation, onEditOperation, onDeleteOperation, renderOperationActions, actions, footerSlot, renderItem, empty, className, strings: stringsProp, }: ProductOperationsCardProps): import("react").JSX.Element;
 export declare namespace ProductOperationsCard {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 export declare function ProductOptionActionMenu({ option, index, onSelectOption, onEditOption, onDeleteOption, renderOptionActions, menuLabel, className, strings: stringsProp, }: ProductOptionActionMenuProps): import("react").JSX.Element | null;
 export declare namespace ProductOptionActionMenu {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,4 +1,9 @@
 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.
+ */
 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 {
     var displayName: string;

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

@@ -1,5 +1,27 @@
-import type { ProductVariantActionMenuProps } from '../products.types';
+import type { ReactNode } from 'react';
+import { type ProductVariantActionMenuStrings } from '../products.strings';
+import type { ProductVariantActionMenuProps, ProductVariantSummary } from '../products.types';
+type VariantCommandHandlers = Pick<ProductVariantActionMenuProps, 'onSelectVariant' | 'onEditVariant' | 'onDuplicateVariant' | 'onDeleteVariant'>;
+interface VariantCommand {
+    id: string;
+    label: string;
+    icon: ReactNode;
+    onClick: () => void;
+    tone: 'secondary' | 'destructive';
+    buttonStyle?: 'ghost';
+}
+/**
+ * The default variant commands, in order, with the destructive one last. The
+ * row menu and the details card's single overflow menu both build on these.
+ */
+export declare function productVariantMenuActions(variant: ProductVariantSummary, { onSelectVariant, onEditVariant, onDuplicateVariant, onDeleteVariant }: VariantCommandHandlers, strings: ProductVariantActionMenuStrings): VariantCommand[];
+/**
+ * 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.
+ */
 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 {
     var displayName: string;
 }
+export {};

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

@@ -2,7 +2,7 @@ import type { ReactNode } from 'react';
 import type { CardProps } from '../../base/cards';
 import type { BadgeTone } from '../../base/badge';
 import type { ActionMenuAction } from '../../base/action-menu';
-import type { MetadataListItem } from '../../blocks/data-display/metadata';
+import type { MetadataListItem } from '../../base/metadata-list';
 import type { StringsProp } from '../../../lib/strings';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
 import type { ProductContractOverviewStrings, ProductDetailsCardStrings, ProductOperationsCardStrings, ProductOptionActionMenuStrings, ProductOptionsMatrixStrings, ProductOptionsSummaryStrings, ProductOverviewStrings, ProductPoliciesCardStrings, ProductQuotePreviewCardStrings, ProductReadinessCardStrings, ProductStructureCardStrings, ProductVariantActionMenuStrings, ProductVariantBulkTableStrings, ProductVariantDetailsStrings, ProductVariantEditorStrings, ProductVariantsManagerStrings, ProductVariantsTableStrings } from './products.strings';
@@ -720,12 +720,19 @@ export interface ProductVariantsBulkTableProps {
     onDuplicateVariant?: (variant: ProductVariantRow) => void;
     /** Fired when a variant is removed. */
     onDeleteVariant?: (variant: ProductVariantRow) => void;
+    /** Fired with the selected variants from the bulk bar's edit command. */
     onBulkEdit?: (variants: ProductVariantRow[]) => void;
+    /** Fired with the selected variants from the bulk bar's apply command, ordered before delete. */
     onBulkApply?: (variants: ProductVariantRow[]) => void;
+    /** Fired with the selected variants from the bulk bar's delete command, always last. */
     onBulkDelete?: (variants: ProductVariantRow[]) => void;
     /** Replaces the per-variant action controls. */
     renderVariantActions?: (variant: ProductVariantRow, context: ProductVariantActionContext) => ReactNode;
-    /** Replaces the per-bulk action controls. */
+    /**
+     * Replaces the default bulk commands (edit, apply, delete) in the inline
+     * BatchActionBar, which shows only while variants are selected and keeps its
+     * own count and Clear. Returning `null` or `undefined` keeps the defaults.
+     */
     renderBulkActions?: (context: ProductVariantBulkActionContext) => ReactNode;
     /** Overflow menu for the surface as a whole. */
     actions?: ActionMenuAction[];

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

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

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

@@ -1,5 +1,5 @@
 import type { ResourceActionBarProps, ResourceDetailsSectionProps, ResourceEmptyStateProps, ResourceHeaderProps, ResourceIndexShellProps, ResourceShowShellProps, TabbedResourceShellProps } from './resource.types';
-export declare function ResourceHeader({ title, description, eyebrow, media, avatarUrl, avatarAlt, avatarFallback, icon, iconTone, badges, metadata, actions, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
+export declare function ResourceHeader({ title, description, eyebrow, media, avatarUrl, avatarAlt, avatarFallback, icon, iconTone, badges, metadata, actions, primaryAction, secondaryActions, moreActionsLabel, renderLink, className, contentClassName, mediaClassName, }: ResourceHeaderProps): import("react").JSX.Element;
 export declare function ResourceActionBar({ children, leading, trailing, sticky, className }: ResourceActionBarProps): import("react").JSX.Element;
 export declare function ResourceEmptyState(props: ResourceEmptyStateProps): import("react").JSX.Element;
 export declare function ResourceIndexShell(props: ResourceIndexShellProps): import("react").JSX.Element;

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

@@ -1,8 +1,9 @@
 import type { ComponentType, ReactNode } from 'react';
 import type { IconBadgeTone } from '../../base/display';
-import type { EmptyStateProps, MetadataListItem } from '../../blocks/data-display';
+import type { MetadataListItem } from '../../base/metadata-list';
+import type { EmptyStateProps } from '../../blocks/data-display';
 import type { ActionMenuAction } from '../../base/action-menu';
-import type { OverflowTabItem } from '../../base/navigation';
+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';
@@ -26,14 +27,37 @@ export interface ResourceShellSlots {
     /** Replaces the default error state. */
     error?: ReactNode;
 }
-export interface ResourceIndexShellProps {
+/**
+ * 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, visible at every width. */
+    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[];
+    /** 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;
+}
+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;
-    /** Generated header actions. */
+    /**
+     * 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;
@@ -62,7 +86,7 @@ export interface ResourceShowShellProps extends ResourceIndexShellProps {
     /** Class name for `slots.aside`. */
     asideClassName?: string;
 }
-export interface ResourceHeaderProps {
+export interface ResourceHeaderProps extends ResourceHeaderCommandProps {
     /** Primary resource identity. */
     title: ReactNode;
     /** Supporting resource summary. */
@@ -87,7 +111,11 @@ export interface ResourceHeaderProps {
     badges?: ReactNode;
     /** Compact resource facts rendered below the description. */
     metadata?: ReactNode;
-    /** Primary and secondary header actions. */
+    /**
+     * 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;

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

@@ -1,5 +1,6 @@
 export { RichTextEditor } from './rich-text-editor';
 export { FormRichTextEditor, type FormRichTextEditorProps } from './form-rich-text-editor';
-export type { RichTextEditorProps, RichTextEditorHandle, RichTextEditorToolbarItem, RichTextCaretContext, ToolbarButtonConfig, } from './rich-text-editor.types';
+export type { RichTextEditorProps, RichTextEditorHandle, RichTextEditorToolbarItem, RichTextCaretContext, ToolbarButtonConfig, RichTextEditorImages, RichTextImage, RichTextImageUploadContext, } from './rich-text-editor.types';
+export { useRichTextImages } from './use-rich-text-images';
 export { defaultRichTextEditorStrings, type RichTextEditorStrings, } from './rich-text-editor.strings';
 export { RichTextEditorToolbar, type RichTextEditorToolbarProps, CountsFooterText, type CountsFooterTextProps, } from './partials';

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

@@ -0,0 +1,13 @@
+import * as TiptapReact from '@tiptap/react';
+/**
+ * An inline image whose source passes the package image policy; any other
+ * `<img>` in loaded or pasted content is dropped. Serializes as a plain
+ * `<img src alt width height>`, matching the contenteditable engine.
+ */
+export declare function getImageNode(): TiptapReact.Node;
+/**
+ * The placeholder an image occupies while it uploads. It is never parsed from
+ * HTML and the editor strips it from its value; the editor renders the
+ * upload status into its node view.
+ */
+export declare function getImageUploadNode(): TiptapReact.Node;

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

@@ -0,0 +1,66 @@
+import { type RefObject } from 'react';
+import type { RichTextEditorStrings } from '../rich-text-editor.strings';
+import type { RichTextEditorImages, RichTextEditorToolbarItem, RichTextImage } from '../rich-text-editor.types';
+export declare const DEFAULT_IMAGE_ACCEPT = "image/png,image/jpeg,image/gif,image/webp";
+/** Marks an upload placeholder in the editing surface; never part of the value. */
+export declare const UPLOAD_ATTRIBUTE = "data-rte-upload";
+/** The placeholder occupies a line of its own while its image uploads. */
+export declare const UPLOAD_PLACEHOLDER_CLASS = "rich-text-editor--upload my-space-xs flex min-h-control items-center rounded-inner border border-dashed border-input bg-muted/30 px-row-x py-row-y";
+/** Removes upload placeholders from serialized editor HTML. */
+export declare function stripUploadPlaceholders(html: string): string;
+export declare function acceptsImageFile(file: File, accept: string): boolean;
+/** A readable default description from the file name: `team-offsite_2026.jpg` → `team offsite 2026`. */
+export declare function altFromFileName(name: string): string;
+/** Image files carried by a paste or drop. */
+export declare function imageFilesFrom(data: DataTransfer | null | undefined): File[];
+/** How each editor engine puts placeholders and images into its document. */
+export interface ImageUploadAdapter {
+    /** Inserts an empty placeholder for `id` at the selection (or the drop point). */
+    insertPlaceholder: (id: string) => void;
+    /** Swaps the placeholder for the uploaded image and reports the change. */
+    resolvePlaceholder: (id: string, image: RichTextImage) => void;
+    /** Removes the placeholder and reports the change. */
+    removePlaceholder: (id: string) => void;
+    /** The placeholder's element, or null once the user has deleted it. */
+    findPlaceholder: (id: string) => HTMLElement | null;
+}
+export interface PendingImageUpload {
+    id: string;
+    name: string;
+    status: 'uploading' | 'error';
+}
+/**
+ * The engine-agnostic upload lifecycle: validate, insert a placeholder, call
+ * the consumer's `upload` with an abort signal, then swap in the image or keep
+ * the placeholder in its error state for Retry or Remove.
+ */
+export declare function useImageUploadQueue(images: RichTextEditorImages | undefined, adapterRef: RefObject<ImageUploadAdapter | null>, strings: RichTextEditorStrings['images']): {
+    uploads: PendingImageUpload[];
+    notice: string | null;
+    dismissNotice: () => void;
+    addFiles: (files: readonly File[]) => void;
+    retry: (id: string) => void;
+    remove: (id: string) => void;
+    prune: () => void;
+};
+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 }: {
+    queue: ImageUploadQueue;
+    adapterRef: RefObject<ImageUploadAdapter | null>;
+    strings: RichTextEditorStrings['images'];
+}): 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): {
+    item: RichTextEditorToolbarItem | null;
+    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 }: {
+    alt: string | null;
+    onAltChange: (alt: string) => void;
+    onRemove: () => void;
+    notice: string | null;
+    onDismissNotice: () => void;
+    strings: RichTextEditorStrings['images'];
+}): import("react").JSX.Element | null;

package/dist/components/features/rich-text-editor/partials/inline-reference-node.d.ts

@@ -0,0 +1,19 @@
+import * as TiptapReact from '@tiptap/react';
+/**
+ * Inline references (`@person`, `#booking`) as one atomic editor token.
+ *
+ * The serialized HTML is the mentions contract written by `buildMentionHtml`
+ * and read by `parseMentionsFromHtml`/`MentionContent`:
+ *
+ *   <span class="rsc-mention" data-ref-id="…" data-ref-kind="…" data-ref-tone="…"
+ *         contenteditable="false">@Label</span>
+ *
+ * Without this node the editor schema had no place for that span, so a picked
+ * mention collapsed into plain text. Inside the editor the token keeps the
+ * `.rsc-mention` hook, so mention-chip.css (the inline Badge utilities and
+ * shared tone tints) draws it exactly as it draws serialized chips; it is
+ * selectable as a unit, and Backspace/Delete remove it in one keystroke.
+ */
+export declare const inlineReferenceChipClassName = "rsc-mention inline-reference--chip";
+/** Created on first use, so the optional Tiptap runtime is only touched by the editor that needs it. */
+export declare function getInlineReferenceNode(): TiptapReact.Node;

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

@@ -2,6 +2,6 @@
 export declare const richTextEditorRecipes: {
     readonly source: string;
     readonly frame: "min-w-0 overflow-hidden border-input bg-background rounded-inner border";
-    readonly disabled: "opacity-70";
+    readonly disabled: "opacity-50";
     readonly content: "h-full [&_.ProseMirror]:h-full [&_.ProseMirror]:min-h-full [&_.ProseMirror]:outline-none";
 };

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

@@ -28,5 +28,19 @@ export interface RichTextEditorStrings {
         words: string;
         max: string;
     };
+    /** Image insertion, upload and description copy; `{{name}}` is the file name. */
+    images: {
+        insert: string;
+        uploading: string;
+        failed: string;
+        unsupported: string;
+        tooLarge: string;
+        cancel: string;
+        retry: string;
+        remove: string;
+        descriptionLabel: string;
+        descriptionHint: string;
+        removeImage: string;
+    };
 }
 export declare const defaultRichTextEditorStrings: RichTextEditorStrings;

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

@@ -1,6 +1,7 @@
 import type { ComponentType, ReactNode } from 'react';
 import type * as TiptapReact from '@tiptap/react';
 import type { StringsProp } from '../../../lib/strings';
+import type { RichTextImageRendering } from '../../typography/rich-text';
 import type { RichTextEditorStrings } from './rich-text-editor.strings';
 export type TiptapEditor = NonNullable<ReturnType<typeof TiptapReact.useEditor>>;
 /**
@@ -52,9 +53,45 @@ export interface RichTextEditorToolbarItem {
     label: string;
     onClick: () => void;
     isActive?: () => boolean;
+    /**
+     * Whether the entry is an on/off toggle, announced with `aria-pressed`.
+     * Defaults to true when `isActive` is provided; set false for a command.
+     */
+    toggle?: boolean;
     /** Renders the entry as unselectable. */
     disabled?: boolean;
 }
+/** Where an uploaded image now lives, as the consumer's `upload` resolves it. */
+export interface RichTextImage {
+    /** Public URL of the stored image. Must pass the image policy: http(s), `blob:` or relative. */
+    src: string;
+    /** Text alternative. Defaults to the file name; the user can edit it in the editor. */
+    alt?: string;
+    /** Intrinsic width in CSS pixels, kept on the image to reserve its space. */
+    width?: number;
+    /** Intrinsic height in CSS pixels. */
+    height?: number;
+}
+export interface RichTextImageUploadContext {
+    /** Aborted when the user cancels or removes the pending image, or the editor unmounts. */
+    signal: AbortSignal;
+}
+/**
+ * Image support for `RichTextEditor` and read-only `RichText`. The consumer
+ * owns upload and storage; the editor owns insertion (toolbar, paste and drop),
+ * the uploading placeholder, error and retry, alt text and source policy.
+ * Create it with `useRichTextImages` so inline callbacks stay stable.
+ */
+export interface RichTextEditorImages extends RichTextImageRendering {
+    /** Stores a file and resolves where it now lives. A rejection shows the error state with Retry. */
+    upload: (file: File, context: RichTextImageUploadContext) => Promise<RichTextImage>;
+    /** Accepted MIME types, comma-separated. Default: `'image/png,image/jpeg,image/gif,image/webp'`. */
+    accept?: string;
+    /** Largest accepted file in bytes. Larger files are refused before upload. */
+    maxSize?: number;
+    /** Receives upload failures and refused files, for reporting. */
+    onError?: (error: unknown, file: File) => void;
+}
 export interface RichTextEditorProps {
     /** Editor content as HTML. Controlled. */
     value: string;
@@ -94,6 +131,12 @@ export interface RichTextEditorProps {
     onCaretChange?: () => void;
     /** Per-instance string overrides (deep-merged over `defaultRichTextEditorStrings`). */
     strings?: StringsProp<RichTextEditorStrings>;
+    /**
+     * Enables images: an Insert image toolbar control, pasted and dropped image
+     * files, an uploading placeholder with cancel, error and retry, and an image
+     * description field for the image at the caret. Omit to keep images out.
+     */
+    images?: RichTextEditorImages;
 }
 export interface ToolbarButtonConfig {
     /** Stable identity for this entry. */
@@ -106,6 +149,8 @@ export interface ToolbarButtonConfig {
     label: string;
     isActive: () => boolean;
     run: () => void;
+    /** An on/off format such as bold, announced with `aria-pressed`. Commands such as undo leave it unset. */
+    toggle?: boolean;
     /** Renders the entry as unselectable. */
     disabled?: boolean;
 }

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

@@ -0,0 +1,18 @@
+import type { RichTextEditorImages } from './rich-text-editor.types';
+/**
+ * Image support for `RichTextEditor` and read-only `RichText` from one place.
+ * The consumer supplies `upload` (and optionally `renderImage`, such as a
+ * framework image component); the returned object is stable across renders
+ * while always calling the latest callbacks, so inline functions are fine.
+ *
+ *   const images = useRichTextImages({
+ *     upload: async (file, { signal }) => {
+ *       const stored = await api.uploadImage(file, { signal });
+ *       return { src: stored.url, width: stored.width, height: stored.height };
+ *     },
+ *     renderImage: (image) => <Image {...image} />,
+ *   });
+ *   <RichTextEditor value={html} onValueChange={setHtml} images={images} />
+ *   <RichText html={html} images={images} />
+ */
+export declare function useRichTextImages(options: RichTextEditorImages): RichTextEditorImages;

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

@@ -1,3 +1,26 @@
-export { SyncRangeDialogForm } from './sync-range-dialog-form';
-export type { SyncRangeDialogFormProps, SyncRangeDialogFormSubmit, SyncRangeDialogFormValues, } from './sync.types';
-export { defaultSyncRangeDialogFormStrings, type SyncRangeDialogFormStrings, } from './sync.strings';
+/**
+ * Deprecated compatibility entrypoint.
+ *
+ * `SyncRangeDialogForm` was one application's integration-repair form: a sync
+ * window radio group, optional record-family checkboxes and a numeric `hours`
+ * payload. It carries no behaviour beyond the public choice controls, so new
+ * code composes them directly: `SchemaForm` from
+ * `themelia-react-ui/features/schema-form` with `radio-cards` and
+ * `checkbox-cards` fields, inside an `ActionDialog` when it needs a dialog.
+ * Existing callers keep working through 2.x.
+ */
+export { 
+/** @deprecated Use `SchemaForm` from `themelia-react-ui/features/schema-form` with a `radio-cards` field for the window and a `checkbox-cards` field for the options; map its values to your payload in `onSubmit`. */
+SyncRangeDialogForm, } from './sync-range-dialog-form';
+export type { 
+/** @deprecated Use `SchemaFormProps` from `themelia-react-ui/features/schema-form`. */
+SyncRangeDialogFormProps, 
+/** @deprecated Map `SchemaFormValues` to your own payload in `SchemaForm`'s `onSubmit`. */
+SyncRangeDialogFormSubmit, 
+/** @deprecated Use `SchemaFormValues` from `themelia-react-ui/features/schema-form`. */
+SyncRangeDialogFormValues, } from './sync.types';
+export { 
+/** @deprecated Supply labels and descriptions on the `SchemaForm` field definitions. */
+defaultSyncRangeDialogFormStrings, 
+/** @deprecated Supply labels and descriptions on the `SchemaForm` field definitions. */
+type SyncRangeDialogFormStrings, } from './sync.strings';

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, storageKey, }: DataTableProps<TData, TValue>): import("react").JSX.Element;
+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 namespace DataTable {
     var displayName: string;
 }