@mieweb/ui 0.10.0-dev.9 → 0.11.0-dev.0

package/dist/components/PropertyList/index.d.ts

@@ -0,0 +1,87 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+type InlineEditType = 'text' | 'textarea' | 'number' | 'date' | 'select' | 'email' | 'url' | 'tel';
+interface InlineEditOption {
+    value: string;
+    label: string;
+}
+interface InlineEditLabels {
+    /** Accessible name of the display button. */
+    edit: (label: string) => string;
+    save: string;
+    cancel: string;
+    saving: string;
+    /** Shown when the value is empty and no `placeholder` is given. */
+    empty: string;
+    /** Shown when `onSave` rejects without an `Error` message. */
+    saveFailed: string;
+}
+
+interface PropertyListItem {
+    key: string;
+    label: string;
+    value: string | number | null | undefined;
+    /** Control used when editing; also drives display formatting. */
+    type?: InlineEditType;
+    options?: InlineEditOption[];
+    /** Edit in place with `InlineEdit` (requires `onSave`). */
+    editable?: boolean;
+    /** Helper text under the value. */
+    hint?: string;
+    /** Show a copy-to-clipboard button for non-empty values. */
+    copyable?: boolean;
+    /** Custom display of a non-empty value. */
+    render?: (value: string) => React.ReactNode;
+    validate?: (value: string) => string | undefined;
+    /** Shown for an empty editable value instead of `labels.empty`. */
+    placeholder?: string;
+}
+interface PropertyListGroup {
+    id: string;
+    title: string;
+    items: PropertyListItem[];
+    /** Defaults to true. */
+    defaultOpen?: boolean;
+}
+interface PropertyListLabels {
+    /** Shown for empty values. */
+    empty: string;
+    copy: (label: string) => string;
+    copied: string;
+    showEmpty: (count: number) => string;
+    hideEmpty: (count: number) => string;
+}
+declare const defaultPropertyListLabels: PropertyListLabels;
+declare const listVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const rowVariants: (props?: ({
+    layout?: "inline" | "stacked" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PropertyListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'>, VariantProps<typeof listVariants>, VariantProps<typeof rowVariants> {
+    /** Flat list of properties. Ignored when `groups` is set. */
+    items?: PropertyListItem[];
+    /** Collapsible sections of properties. */
+    groups?: PropertyListGroup[];
+    /** Persist an edited value. Rejecting restores the previous value. */
+    onSave?: (key: string, value: string) => void | Promise<void>;
+    /** Hide empty values behind a "Show N empty fields" toggle. */
+    hideEmpty?: boolean;
+    /** Heading level for group titles. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Remember each group's open state in localStorage under `${storageKey}:${group.id}`. */
+    storageKey?: string;
+    /** Translatable strings. */
+    labels?: Partial<PropertyListLabels>;
+    /** Strings forwarded to each `InlineEdit`. */
+    inlineEditLabels?: Partial<InlineEditLabels>;
+}
+/**
+ * Label/value pairs as a description list, with optional in-place editing,
+ * copy buttons and collapsible groups.
+ */
+declare const PropertyList: React.ForwardRefExoticComponent<PropertyListProps & React.RefAttributes<HTMLDivElement>>;
+
+export { PropertyList, type PropertyListGroup, type PropertyListItem, type PropertyListLabels, type PropertyListProps, defaultPropertyListLabels };

package/dist/components/PropertyList/index.js

@@ -0,0 +1,12 @@
+export { PropertyList, defaultPropertyListLabels } from '../../chunk-7HUTR6RX.js';
+import '../../chunk-M3VPGJMV.js';
+import '../../chunk-5QZ73PZC.js';
+import '../../chunk-VSRO4PAI.js';
+import '../../chunk-6NZXWKUE.js';
+import '../../chunk-3IMM2PM4.js';
+import '../../chunk-XDU65GLW.js';
+import '../../chunk-F4N67NAF.js';
+import '../../chunk-TQONQSJO.js';
+import '../../chunk-PX6F3LHL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/PropertyList/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/Q/index.d.cts

@@ -1,8 +1,8 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 import { AgentConfigGeneratorProps, QConfig, QSchema } from '@mieweb/q';
 export { AgentConfigGenerator, AgentConfigGeneratorProps, ConfigEditor, ConfigEditorProps, FormBuilder, FormBuilderProps, GENERIC_TOOLS, Header, HeaderProps, QConfig, QDownloadMode, QSchema, TIMEZONES, ToolBuilder, ToolBuilderProps, configToQuestionnaire, configToYaml, copyToClipboard, defaultSchema, deriveDefaultConfig, downloadConfig, questionnaireToConfig, validateConfig, yamlToConfig } from '@mieweb/q';
 export { UniversalAgentConfigGenerator, UniversalAgentConfigGeneratorOptions, brands, generateBrandCSS } from '@mieweb/q/universal';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
 
 interface QProps extends AgentConfigGeneratorProps {
     /** Additional class name for the Q container. */

package/dist/components/Q/index.d.ts

@@ -1,8 +1,8 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
 import { AgentConfigGeneratorProps, QConfig, QSchema } from '@mieweb/q';
 export { AgentConfigGenerator, AgentConfigGeneratorProps, ConfigEditor, ConfigEditorProps, FormBuilder, FormBuilderProps, GENERIC_TOOLS, Header, HeaderProps, QConfig, QDownloadMode, QSchema, TIMEZONES, ToolBuilder, ToolBuilderProps, configToQuestionnaire, configToYaml, copyToClipboard, defaultSchema, deriveDefaultConfig, downloadConfig, questionnaireToConfig, validateConfig, yamlToConfig } from '@mieweb/q';
 export { UniversalAgentConfigGenerator, UniversalAgentConfigGeneratorOptions, brands, generateBrandCSS } from '@mieweb/q/universal';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React from 'react';
 
 interface QProps extends AgentConfigGeneratorProps {
     /** Additional class name for the Q container. */

package/dist/components/QuickAction/index.d.cts

@@ -3,7 +3,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import * as React from 'react';
 
 declare const quickActionIconVariants: (props?: ({
-    color?: "primary" | "blue" | "green" | "orange" | "purple" | "red" | "neutral" | "amber" | null | undefined;
+    color?: "primary" | "green" | "purple" | "orange" | "blue" | "red" | "amber" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const quickActionVariants: (props?: ({
     disabled?: boolean | null | undefined;

package/dist/components/QuickAction/index.d.ts

@@ -3,7 +3,7 @@ import * as class_variance_authority_types from 'class-variance-authority/types'
 import * as React from 'react';
 
 declare const quickActionIconVariants: (props?: ({
-    color?: "primary" | "blue" | "green" | "orange" | "purple" | "red" | "neutral" | "amber" | null | undefined;
+    color?: "primary" | "green" | "purple" | "orange" | "blue" | "red" | "amber" | "neutral" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const quickActionVariants: (props?: ({
     disabled?: boolean | null | undefined;

package/dist/components/RadialExplorer/index.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunk6EN3IQQI_cjs = require('../../chunk-6EN3IQQI.cjs');
+var chunkL5Y52F2E_cjs = require('../../chunk-L5Y52F2E.cjs');
 require('../../chunk-VBWRH4UW.cjs');
-require('../../chunk-6HFFWEM3.cjs');
-require('../../chunk-YVL3XATO.cjs');
-require('../../chunk-VNYW4C4J.cjs');
+require('../../chunk-YW2AKBLS.cjs');
+require('../../chunk-7E46YDOT.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 require('../../chunk-EUAMEVVI.cjs');
 
@@ -12,7 +14,7 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "RadialExplorer", {
   enumerable: true,
-  get: function () { return chunk6EN3IQQI_cjs.RadialExplorer; }
+  get: function () { return chunkL5Y52F2E_cjs.RadialExplorer; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/RadialExplorer/index.js

@@ -1,8 +1,10 @@
-export { RadialExplorer } from '../../chunk-Y5HFM7LO.js';
+export { RadialExplorer } from '../../chunk-VOEXGDL5.js';
 import '../../chunk-IQ4KQJAO.js';
-import '../../chunk-HB7C7NB5.js';
-import '../../chunk-BMSG4NBH.js';
-import '../../chunk-GOALNQZ2.js';
+import '../../chunk-XDU65GLW.js';
+import '../../chunk-522WJIVI.js';
+import '../../chunk-N5JDL4VE.js';
+import '../../chunk-WFBUBT54.js';
+import '../../chunk-GVM6DTR5.js';
 import '../../chunk-TQONQSJO.js';
 import '../../chunk-PX6F3LHL.js';
 //# sourceMappingURL=index.js.map

package/dist/components/Rating/index.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+var chunkXNPDZANN_cjs = require('../../chunk-XNPDZANN.cjs');
+require('../../chunk-IVGI353O.cjs');
+require('../../chunk-GKDHMNUA.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "Rating", {
+  enumerable: true,
+  get: function () { return chunkXNPDZANN_cjs.Rating; }
+});
+Object.defineProperty(exports, "ReviewCard", {
+  enumerable: true,
+  get: function () { return chunkXNPDZANN_cjs.ReviewCard; }
+});
+Object.defineProperty(exports, "defaultRatingLabels", {
+  enumerable: true,
+  get: function () { return chunkXNPDZANN_cjs.defaultRatingLabels; }
+});
+Object.defineProperty(exports, "defaultReviewCardLabels", {
+  enumerable: true,
+  get: function () { return chunkXNPDZANN_cjs.defaultReviewCardLabels; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/Rating/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/Rating/index.d.cts

@@ -0,0 +1,85 @@
+import * as React from 'react';
+
+interface RatingLabels {
+    /** Accessible text of the read-only display, e.g. `4.5 out of 5`. */
+    value: (value: number, max: number) => string;
+    /** Accessible name of the interactive radio group. */
+    group: string;
+    /** Accessible name of one option, e.g. `3 stars`. */
+    option: (value: number, max: number) => string;
+}
+declare const defaultRatingLabels: RatingLabels;
+interface RatingProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Current rating; read-only displays round to the nearest half. */
+    value: number;
+    /** Number of stars. */
+    max?: number;
+    /** Star size. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Makes the rating editable as a radio group of whole stars. */
+    onChange?: (value: number) => void;
+    /** Disables the interactive mode. */
+    disabled?: boolean;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<RatingLabels>;
+}
+/**
+ * Star rating: a read-only display with half-star precision, or — with
+ * `onChange` — a keyboard-operable radio group.
+ *
+ * @example
+ * ```tsx
+ * <Rating value={4.5} />
+ * <Rating value={stars} onChange={setStars} />
+ * ```
+ */
+declare const Rating: React.ForwardRefExoticComponent<RatingProps & React.RefAttributes<HTMLDivElement>>;
+
+interface ReviewCardLabels {
+    /** Source line, e.g. `via Google`. */
+    source: (source: string) => string;
+    /** Accessible name of the reply region. */
+    reply: string;
+    showMore: string;
+    showLess: string;
+}
+declare const defaultReviewCardLabels: ReviewCardLabels;
+interface ReviewCardProps extends React.HTMLAttributes<HTMLElement> {
+    /** Who wrote the review. */
+    author: {
+        name: string;
+        avatarUrl?: string | null;
+    };
+    /** When it was written — ISO string or Date. */
+    date: string | Date;
+    /** Show the date as `3 days ago` (default) or as a localized date. */
+    dateStyle?: 'relative' | 'absolute';
+    /** BCP 47 locale for the date; defaults to the runtime locale. */
+    locale?: string;
+    /** Star rating, half-star precision. */
+    rating: number;
+    /** Review text; long bodies clamp with a Show more toggle. */
+    body: string;
+    /** Where the review came from, e.g. `Google`. */
+    source?: string;
+    /** Owner response shown under the review. */
+    reply?: React.ReactNode;
+    /** Lines shown before the body clamps. */
+    bodyLines?: 2 | 3 | 4 | 5 | 6;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<ReviewCardLabels>;
+    /** Forwarded to the embedded Rating. */
+    ratingLabels?: Partial<RatingLabels>;
+}
+/**
+ * One review: author, star rating, date, source, clamped body and an optional
+ * owner reply.
+ *
+ * @example
+ * ```tsx
+ * <ReviewCard author={{ name: 'Ann L.' }} date="2026-09-01" rating={4} body={text} source="Google" />
+ * ```
+ */
+declare const ReviewCard: React.ForwardRefExoticComponent<ReviewCardProps & React.RefAttributes<HTMLElement>>;
+
+export { Rating, type RatingLabels, type RatingProps, ReviewCard, type ReviewCardLabels, type ReviewCardProps, defaultRatingLabels, defaultReviewCardLabels };

package/dist/components/Rating/index.d.ts

@@ -0,0 +1,85 @@
+import * as React from 'react';
+
+interface RatingLabels {
+    /** Accessible text of the read-only display, e.g. `4.5 out of 5`. */
+    value: (value: number, max: number) => string;
+    /** Accessible name of the interactive radio group. */
+    group: string;
+    /** Accessible name of one option, e.g. `3 stars`. */
+    option: (value: number, max: number) => string;
+}
+declare const defaultRatingLabels: RatingLabels;
+interface RatingProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Current rating; read-only displays round to the nearest half. */
+    value: number;
+    /** Number of stars. */
+    max?: number;
+    /** Star size. */
+    size?: 'sm' | 'md' | 'lg';
+    /** Makes the rating editable as a radio group of whole stars. */
+    onChange?: (value: number) => void;
+    /** Disables the interactive mode. */
+    disabled?: boolean;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<RatingLabels>;
+}
+/**
+ * Star rating: a read-only display with half-star precision, or — with
+ * `onChange` — a keyboard-operable radio group.
+ *
+ * @example
+ * ```tsx
+ * <Rating value={4.5} />
+ * <Rating value={stars} onChange={setStars} />
+ * ```
+ */
+declare const Rating: React.ForwardRefExoticComponent<RatingProps & React.RefAttributes<HTMLDivElement>>;
+
+interface ReviewCardLabels {
+    /** Source line, e.g. `via Google`. */
+    source: (source: string) => string;
+    /** Accessible name of the reply region. */
+    reply: string;
+    showMore: string;
+    showLess: string;
+}
+declare const defaultReviewCardLabels: ReviewCardLabels;
+interface ReviewCardProps extends React.HTMLAttributes<HTMLElement> {
+    /** Who wrote the review. */
+    author: {
+        name: string;
+        avatarUrl?: string | null;
+    };
+    /** When it was written — ISO string or Date. */
+    date: string | Date;
+    /** Show the date as `3 days ago` (default) or as a localized date. */
+    dateStyle?: 'relative' | 'absolute';
+    /** BCP 47 locale for the date; defaults to the runtime locale. */
+    locale?: string;
+    /** Star rating, half-star precision. */
+    rating: number;
+    /** Review text; long bodies clamp with a Show more toggle. */
+    body: string;
+    /** Where the review came from, e.g. `Google`. */
+    source?: string;
+    /** Owner response shown under the review. */
+    reply?: React.ReactNode;
+    /** Lines shown before the body clamps. */
+    bodyLines?: 2 | 3 | 4 | 5 | 6;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<ReviewCardLabels>;
+    /** Forwarded to the embedded Rating. */
+    ratingLabels?: Partial<RatingLabels>;
+}
+/**
+ * One review: author, star rating, date, source, clamped body and an optional
+ * owner reply.
+ *
+ * @example
+ * ```tsx
+ * <ReviewCard author={{ name: 'Ann L.' }} date="2026-09-01" rating={4} body={text} source="Google" />
+ * ```
+ */
+declare const ReviewCard: React.ForwardRefExoticComponent<ReviewCardProps & React.RefAttributes<HTMLElement>>;
+
+export { Rating, type RatingLabels, type RatingProps, ReviewCard, type ReviewCardLabels, type ReviewCardProps, defaultRatingLabels, defaultReviewCardLabels };

package/dist/components/Rating/index.js

@@ -0,0 +1,7 @@
+export { Rating, ReviewCard, defaultRatingLabels, defaultReviewCardLabels } from '../../chunk-CBBKWRLG.js';
+import '../../chunk-VU3ZMJBN.js';
+import '../../chunk-TI3TQQ7F.js';
+import '../../chunk-TQONQSJO.js';
+import '../../chunk-PX6F3LHL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/Rating/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/RecordButton/index.d.cts

@@ -47,7 +47,7 @@ interface RecordButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonEl
     mimeType?: string;
 }
 declare const recordButtonVariants: (props?: ({
-    variant?: "default" | "ghost" | "outline" | "minimal" | null | undefined;
+    variant?: "default" | "outline" | "ghost" | "minimal" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function formatDuration(seconds: number): string;

package/dist/components/RecordButton/index.d.ts

@@ -47,7 +47,7 @@ interface RecordButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonEl
     mimeType?: string;
 }
 declare const recordButtonVariants: (props?: ({
-    variant?: "default" | "ghost" | "outline" | "minimal" | null | undefined;
+    variant?: "default" | "outline" | "ghost" | "minimal" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare function formatDuration(seconds: number): string;

package/dist/components/RecordHeader/index.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+var chunkIEZXJWHJ_cjs = require('../../chunk-IEZXJWHJ.cjs');
+require('../../chunk-PINIBEIU.cjs');
+require('../../chunk-GKDHMNUA.cjs');
+require('../../chunk-I44YNYI6.cjs');
+require('../../chunk-Z5S5JEJD.cjs');
+require('../../chunk-FHY3K6PL.cjs');
+require('../../chunk-FSGEDDF2.cjs');
+require('../../chunk-AOHJILLU.cjs');
+require('../../chunk-Z3WMDVMR.cjs');
+require('../../chunk-7E46YDOT.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
+require('../../chunk-IEY3ZJIT.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "RecordHeader", {
+  enumerable: true,
+  get: function () { return chunkIEZXJWHJ_cjs.RecordHeader; }
+});
+Object.defineProperty(exports, "defaultRecordHeaderLabels", {
+  enumerable: true,
+  get: function () { return chunkIEZXJWHJ_cjs.defaultRecordHeaderLabels; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/RecordHeader/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/components/RecordHeader/index.d.cts

@@ -0,0 +1,96 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "secondary" | "success" | "warning" | "danger" | "outline" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    removable?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, Omit<VariantProps<typeof badgeVariants>, 'removable'> {
+    /** Optional icon before the text */
+    icon?: React.ReactNode;
+    /** Renders a remove button after the text; the badge becomes a chip. */
+    onRemove?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Accessible name of the remove button. Always pass a translated string;
+     * the English default only guards against a missing label.
+     */
+    removeLabel?: string;
+    /** Disables the remove button. */
+    removeDisabled?: boolean;
+}
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "secondary" | "danger" | "outline" | "primary" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | "icon" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    effect?: "none" | "sheen" | "orbit" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    /** Optional icon element to render before the button text */
+    leftIcon?: React.ReactElement | null;
+    /** Optional icon element to render after the button text */
+    rightIcon?: React.ReactElement | null;
+    /** Shows a loading spinner and disables the button */
+    isLoading?: boolean;
+    /** Accessible label for the loading state */
+    loadingText?: string;
+}
+
+interface RecordHeaderBadge {
+    id: string;
+    label: string;
+    variant?: BadgeProps['variant'];
+}
+interface RecordHeaderMetaItem {
+    id: string;
+    label: string;
+    icon?: LucideIcon;
+    href?: string;
+}
+interface RecordHeaderAction {
+    id: string;
+    label: string;
+    icon?: LucideIcon;
+    /** With `href`, call `event.preventDefault()` to route client-side. */
+    onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+    href?: string;
+    /** Defaults to `primary` for the first action and `outline` for the rest. */
+    variant?: ButtonProps['variant'];
+    disabled?: boolean;
+}
+interface RecordHeaderLabels {
+    back: string;
+    moreActions: string;
+    meta: string;
+}
+declare const defaultRecordHeaderLabels: RecordHeaderLabels;
+interface RecordHeaderProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    title: React.ReactNode;
+    headingLevel?: 'h1' | 'h2' | 'h3';
+    subtitle?: React.ReactNode;
+    avatar?: {
+        src?: string | null;
+        name: string;
+    };
+    icon?: LucideIcon;
+    /** Replaces avatar/icon, e.g. a company logo. */
+    media?: React.ReactNode;
+    badges?: RecordHeaderBadge[];
+    meta?: RecordHeaderMetaItem[];
+    actions?: RecordHeaderAction[];
+    /** Actions shown as buttons from `sm` up; the rest go to the overflow menu. */
+    maxVisibleActions?: number;
+    presence?: React.ReactNode;
+    breadcrumbs?: React.ReactNode;
+    onBack?: (event: React.MouseEvent<HTMLElement>) => void;
+    backHref?: string;
+    sticky?: boolean;
+    labels?: Partial<RecordHeaderLabels>;
+}
+declare const RecordHeader: React.ForwardRefExoticComponent<RecordHeaderProps & React.RefAttributes<HTMLElement>>;
+
+export { RecordHeader, type RecordHeaderAction, type RecordHeaderBadge, type RecordHeaderLabels, type RecordHeaderMetaItem, type RecordHeaderProps, defaultRecordHeaderLabels };

package/dist/components/RecordHeader/index.d.ts

@@ -0,0 +1,96 @@
+import * as React from 'react';
+import { LucideIcon } from 'lucide-react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+declare const badgeVariants: (props?: ({
+    variant?: "default" | "secondary" | "success" | "warning" | "danger" | "outline" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    removable?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, Omit<VariantProps<typeof badgeVariants>, 'removable'> {
+    /** Optional icon before the text */
+    icon?: React.ReactNode;
+    /** Renders a remove button after the text; the badge becomes a chip. */
+    onRemove?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /**
+     * Accessible name of the remove button. Always pass a translated string;
+     * the English default only guards against a missing label.
+     */
+    removeLabel?: string;
+    /** Disables the remove button. */
+    removeDisabled?: boolean;
+}
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "secondary" | "danger" | "outline" | "primary" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | "icon" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    effect?: "none" | "sheen" | "orbit" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    /** Optional icon element to render before the button text */
+    leftIcon?: React.ReactElement | null;
+    /** Optional icon element to render after the button text */
+    rightIcon?: React.ReactElement | null;
+    /** Shows a loading spinner and disables the button */
+    isLoading?: boolean;
+    /** Accessible label for the loading state */
+    loadingText?: string;
+}
+
+interface RecordHeaderBadge {
+    id: string;
+    label: string;
+    variant?: BadgeProps['variant'];
+}
+interface RecordHeaderMetaItem {
+    id: string;
+    label: string;
+    icon?: LucideIcon;
+    href?: string;
+}
+interface RecordHeaderAction {
+    id: string;
+    label: string;
+    icon?: LucideIcon;
+    /** With `href`, call `event.preventDefault()` to route client-side. */
+    onClick?: (event: React.MouseEvent<HTMLElement>) => void;
+    href?: string;
+    /** Defaults to `primary` for the first action and `outline` for the rest. */
+    variant?: ButtonProps['variant'];
+    disabled?: boolean;
+}
+interface RecordHeaderLabels {
+    back: string;
+    moreActions: string;
+    meta: string;
+}
+declare const defaultRecordHeaderLabels: RecordHeaderLabels;
+interface RecordHeaderProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    title: React.ReactNode;
+    headingLevel?: 'h1' | 'h2' | 'h3';
+    subtitle?: React.ReactNode;
+    avatar?: {
+        src?: string | null;
+        name: string;
+    };
+    icon?: LucideIcon;
+    /** Replaces avatar/icon, e.g. a company logo. */
+    media?: React.ReactNode;
+    badges?: RecordHeaderBadge[];
+    meta?: RecordHeaderMetaItem[];
+    actions?: RecordHeaderAction[];
+    /** Actions shown as buttons from `sm` up; the rest go to the overflow menu. */
+    maxVisibleActions?: number;
+    presence?: React.ReactNode;
+    breadcrumbs?: React.ReactNode;
+    onBack?: (event: React.MouseEvent<HTMLElement>) => void;
+    backHref?: string;
+    sticky?: boolean;
+    labels?: Partial<RecordHeaderLabels>;
+}
+declare const RecordHeader: React.ForwardRefExoticComponent<RecordHeaderProps & React.RefAttributes<HTMLElement>>;
+
+export { RecordHeader, type RecordHeaderAction, type RecordHeaderBadge, type RecordHeaderLabels, type RecordHeaderMetaItem, type RecordHeaderProps, defaultRecordHeaderLabels };