@mieweb/ui 0.10.0-dev.30 → 0.10.0-dev.32

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

@@ -1,12 +1,21 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 
+type AvatarPresence = 'viewing' | 'editing';
+
 /** Another participant currently present in the room. */
 interface CollabPeer {
     /** Display name published through presence. */
     name: string;
     /** Optional presence color (cursor/avatar tint). */
     color?: string;
+    /**
+     * What the peer is doing. Peers without a mode count as editing; `viewing`
+     * peers are left out of the "… are editing" summary.
+     */
+    mode?: AvatarPresence;
+    /** Avatar image URL. */
+    avatarUrl?: string;
 }
 /** Static identity of the open collaboration room, shown in the debug panel. */
 interface CollabRoomInfo {
@@ -48,6 +57,8 @@ interface CollabStatusLabels {
     peersTitle: (count: number) => string;
     /** Shown in the occupants section when nobody else is in the room. */
     alone: React.ReactNode;
+    /** Accessible name of an occupant with a `mode`, e.g. `Ann is viewing`. */
+    presence?: (name: string, mode: AvatarPresence) => string;
     /** Heading of the debug panel. */
     logTitle: (count: number) => string;
     /** Accessible name of the panel close button. */

package/dist/components/CollabStatus/index.js

@@ -1,4 +1,6 @@
-export { CollabStatus, defaultCollabStatusLabels, useYjsCollabStatus } from '../../chunk-SVSHA7XV.js';
+export { CollabStatus, defaultCollabStatusLabels, useYjsCollabStatus } from '../../chunk-O6XDA3SI.js';
+import '../../chunk-DVDT7TX7.js';
+import '../../chunk-TI3TQQ7F.js';
 import '../../chunk-TQONQSJO.js';
 import '../../chunk-PX6F3LHL.js';
 //# sourceMappingURL=index.js.map

package/dist/components/Collapsible/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk35Y4ILCU_cjs = require('../../chunk-35Y4ILCU.cjs');
+var chunkVXW7D5LR_cjs = require('../../chunk-VXW7D5LR.cjs');
 require('../../chunk-YW2AKBLS.cjs');
 require('../../chunk-IEY3ZJIT.cjs');
 require('../../chunk-S5RVSXDV.cjs');
@@ -10,15 +10,15 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "Collapsible", {
   enumerable: true,
-  get: function () { return chunk35Y4ILCU_cjs.Collapsible; }
+  get: function () { return chunkVXW7D5LR_cjs.Collapsible; }
 });
 Object.defineProperty(exports, "CollapsibleContent", {
   enumerable: true,
-  get: function () { return chunk35Y4ILCU_cjs.CollapsibleContent; }
+  get: function () { return chunkVXW7D5LR_cjs.CollapsibleContent; }
 });
 Object.defineProperty(exports, "CollapsibleTrigger", {
   enumerable: true,
-  get: function () { return chunk35Y4ILCU_cjs.CollapsibleTrigger; }
+  get: function () { return chunkVXW7D5LR_cjs.CollapsibleTrigger; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

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

@@ -9,6 +9,12 @@ interface CollapsibleProps extends React.HTMLAttributes<HTMLDivElement> {
     onOpenChange?: (open: boolean) => void;
     /** Disables toggling */
     disabled?: boolean;
+    /**
+     * Persists the open state in `localStorage` under this key (uncontrolled
+     * only). Restored after mount, so server and hydration renders use
+     * `defaultOpen`.
+     */
+    storageKey?: string;
 }
 /**
  * An interactive component that expands and collapses its content.

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

@@ -9,6 +9,12 @@ interface CollapsibleProps extends React.HTMLAttributes<HTMLDivElement> {
     onOpenChange?: (open: boolean) => void;
     /** Disables toggling */
     disabled?: boolean;
+    /**
+     * Persists the open state in `localStorage` under this key (uncontrolled
+     * only). Restored after mount, so server and hydration renders use
+     * `defaultOpen`.
+     */
+    storageKey?: string;
 }
 /**
  * An interactive component that expands and collapses its content.

package/dist/components/Collapsible/index.js

@@ -1,4 +1,4 @@
-export { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../../chunk-7ZV67VZE.js';
+export { Collapsible, CollapsibleContent, CollapsibleTrigger } from '../../chunk-VSRO4PAI.js';
 import '../../chunk-XDU65GLW.js';
 import '../../chunk-F4N67NAF.js';
 import '../../chunk-TQONQSJO.js';

package/dist/components/CompletenessMeter/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+var chunkI2MMUFCN_cjs = require('../../chunk-I2MMUFCN.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "CompletenessMeter", {
+  enumerable: true,
+  get: function () { return chunkI2MMUFCN_cjs.CompletenessMeter; }
+});
+Object.defineProperty(exports, "defaultCompletenessMeterLabels", {
+  enumerable: true,
+  get: function () { return chunkI2MMUFCN_cjs.defaultCompletenessMeterLabels; }
+});
+Object.defineProperty(exports, "getCompleteness", {
+  enumerable: true,
+  get: function () { return chunkI2MMUFCN_cjs.getCompleteness; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

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

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

@@ -0,0 +1,52 @@
+import * as React from 'react';
+
+interface CompletenessField {
+    /** Stable key, passed back to `onFieldClick`. */
+    key: string;
+    /** Display name of the field. */
+    label: string;
+    /** Whether the field has a value. */
+    complete: boolean;
+    /** Relative importance; defaults to 1. */
+    weight?: number;
+}
+interface CompletenessMeterLabels {
+    /** Heading of the full variant. */
+    title: string;
+    /** Accessible name of the progress bar. */
+    progress: string;
+    /** Visible percentage and `aria-valuetext`. */
+    percent: (percent: number) => string;
+    /** Heading of the missing-fields list. */
+    missing: (count: number) => string;
+    /** Shown when nothing is missing. */
+    allComplete: string;
+}
+declare const defaultCompletenessMeterLabels: CompletenessMeterLabels;
+/** Weighted completion percentage (0–100) and the incomplete fields. */
+declare function getCompleteness(fields: CompletenessField[]): {
+    percent: number;
+    missing: CompletenessField[];
+};
+interface CompletenessMeterProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Fields that make up the record. */
+    fields: CompletenessField[];
+    /** `compact` shows the bar and percentage only. */
+    variant?: 'default' | 'compact';
+    /** Makes each missing field a button, e.g. to focus its input. */
+    onFieldClick?: (key: string) => void;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<CompletenessMeterLabels>;
+}
+/**
+ * How complete a record is: a weighted percentage, a progress bar and the
+ * list of missing fields.
+ *
+ * @example
+ * ```tsx
+ * <CompletenessMeter fields={fields} onFieldClick={(key) => focusField(key)} />
+ * ```
+ */
+declare const CompletenessMeter: React.ForwardRefExoticComponent<CompletenessMeterProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type CompletenessField, CompletenessMeter, type CompletenessMeterLabels, type CompletenessMeterProps, defaultCompletenessMeterLabels, getCompleteness };

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

@@ -0,0 +1,52 @@
+import * as React from 'react';
+
+interface CompletenessField {
+    /** Stable key, passed back to `onFieldClick`. */
+    key: string;
+    /** Display name of the field. */
+    label: string;
+    /** Whether the field has a value. */
+    complete: boolean;
+    /** Relative importance; defaults to 1. */
+    weight?: number;
+}
+interface CompletenessMeterLabels {
+    /** Heading of the full variant. */
+    title: string;
+    /** Accessible name of the progress bar. */
+    progress: string;
+    /** Visible percentage and `aria-valuetext`. */
+    percent: (percent: number) => string;
+    /** Heading of the missing-fields list. */
+    missing: (count: number) => string;
+    /** Shown when nothing is missing. */
+    allComplete: string;
+}
+declare const defaultCompletenessMeterLabels: CompletenessMeterLabels;
+/** Weighted completion percentage (0–100) and the incomplete fields. */
+declare function getCompleteness(fields: CompletenessField[]): {
+    percent: number;
+    missing: CompletenessField[];
+};
+interface CompletenessMeterProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Fields that make up the record. */
+    fields: CompletenessField[];
+    /** `compact` shows the bar and percentage only. */
+    variant?: 'default' | 'compact';
+    /** Makes each missing field a button, e.g. to focus its input. */
+    onFieldClick?: (key: string) => void;
+    /** Overrides for any user-facing string. */
+    labels?: Partial<CompletenessMeterLabels>;
+}
+/**
+ * How complete a record is: a weighted percentage, a progress bar and the
+ * list of missing fields.
+ *
+ * @example
+ * ```tsx
+ * <CompletenessMeter fields={fields} onFieldClick={(key) => focusField(key)} />
+ * ```
+ */
+declare const CompletenessMeter: React.ForwardRefExoticComponent<CompletenessMeterProps & React.RefAttributes<HTMLDivElement>>;
+
+export { type CompletenessField, CompletenessMeter, type CompletenessMeterLabels, type CompletenessMeterProps, defaultCompletenessMeterLabels, getCompleteness };

package/dist/components/CompletenessMeter/index.js

@@ -0,0 +1,5 @@
+export { CompletenessMeter, defaultCompletenessMeterLabels, getCompleteness } from '../../chunk-6JSFT2J5.js';
+import '../../chunk-TQONQSJO.js';
+import '../../chunk-PX6F3LHL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

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

package/dist/components/CustomizableDashboard/index.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-var chunk3KPDQG5O_cjs = require('../../chunk-3KPDQG5O.cjs');
+var chunkZG6FXMDX_cjs = require('../../chunk-ZG6FXMDX.cjs');
 require('../../chunk-PLMXN23Q.cjs');
 require('../../chunk-RS5VA6QU.cjs');
 require('../../chunk-NNEFAUHV.cjs');
 require('../../chunk-FHY3K6PL.cjs');
 require('../../chunk-SCV7C55E.cjs');
-require('../../chunk-X6A27RGO.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
 require('../../chunk-DXEPYK3I.cjs');
 require('../../chunk-S5RVSXDV.cjs');
 require('../../chunk-EUAMEVVI.cjs');
@@ -15,31 +16,31 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "CustomizableDashboard", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.CustomizableDashboard; }
+  get: function () { return chunkZG6FXMDX_cjs.CustomizableDashboard; }
 });
 Object.defineProperty(exports, "DashboardCustomizePanel", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.DashboardCustomizePanel; }
+  get: function () { return chunkZG6FXMDX_cjs.DashboardCustomizePanel; }
 });
 Object.defineProperty(exports, "consolidateColumns", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.consolidateColumns; }
+  get: function () { return chunkZG6FXMDX_cjs.consolidateColumns; }
 });
 Object.defineProperty(exports, "mergeColumnOrder", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.mergeColumnOrder; }
+  get: function () { return chunkZG6FXMDX_cjs.mergeColumnOrder; }
 });
 Object.defineProperty(exports, "moveAcrossColumns", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.moveAcrossColumns; }
+  get: function () { return chunkZG6FXMDX_cjs.moveAcrossColumns; }
 });
 Object.defineProperty(exports, "reorderOnDrop", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.reorderOnDrop; }
+  get: function () { return chunkZG6FXMDX_cjs.reorderOnDrop; }
 });
 Object.defineProperty(exports, "requiredColumns", {
   enumerable: true,
-  get: function () { return chunk3KPDQG5O_cjs.requiredColumns; }
+  get: function () { return chunkZG6FXMDX_cjs.requiredColumns; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/CustomizableDashboard/index.js

@@ -1,10 +1,11 @@
-export { CustomizableDashboard, DashboardCustomizePanel, consolidateColumns, mergeColumnOrder, moveAcrossColumns, reorderOnDrop, requiredColumns } from '../../chunk-H2IAMSHK.js';
+export { CustomizableDashboard, DashboardCustomizePanel, consolidateColumns, mergeColumnOrder, moveAcrossColumns, reorderOnDrop, requiredColumns } from '../../chunk-TVEJKKIM.js';
 import '../../chunk-AQ564XO7.js';
 import '../../chunk-LMBXJZLG.js';
 import '../../chunk-4SMSH4OY.js';
 import '../../chunk-T4ME7QCT.js';
 import '../../chunk-VSQF22GL.js';
-import '../../chunk-7YO7DNUV.js';
+import '../../chunk-N5JDL4VE.js';
+import '../../chunk-WFBUBT54.js';
 import '../../chunk-GVM6DTR5.js';
 import '../../chunk-TQONQSJO.js';
 import '../../chunk-PX6F3LHL.js';

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

@@ -1,8 +1,40 @@
 import * as React from 'react';
-import { InputProps } from '../Input/index.cjs';
-import 'react/jsx-runtime';
-import 'class-variance-authority/types';
-import 'class-variance-authority';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, Omit<VariantProps<typeof inputVariants>, 'labelVariant'> {
+    /** Error message to display below the input */
+    error?: string;
+    /** Helper text to display below the input */
+    helperText?: string;
+    /** Label for the input */
+    label?: string;
+    /**
+     * How the label is rendered.
+     * - `stacked` (default): label above the input.
+     * - `floating`: label rests inside the input like a placeholder and floats
+     *   to the top of the field (staying inside it) when focused or filled.
+     *   Ignores `placeholder`; when `hideLabel` is set, falls back to a
+     *   visually-hidden stacked label.
+     */
+    labelVariant?: 'stacked' | 'floating';
+    /** Whether the label should be visually hidden (still accessible) */
+    hideLabel?: boolean;
+    /** Whether the input is required */
+    required?: boolean;
+    /**
+     * Color of the required asterisk.
+     * - `default`: destructive (hard requirement).
+     * - `warning`: warning color (soft requirement / recommended).
+     */
+    requiredVariant?: RequiredMarkVariant;
+}
+type RequiredMarkVariant = 'default' | 'warning';
 
 type DateInputMode = 'default' | 'dob' | 'expiration' | 'past' | 'future';
 type DateInputType = 'date' | 'datetime-local' | 'time' | 'month' | 'year';

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

@@ -1,8 +1,40 @@
 import * as React from 'react';
-import { InputProps } from '../Input/index.js';
-import 'react/jsx-runtime';
-import 'class-variance-authority/types';
-import 'class-variance-authority';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    hasError?: boolean | null | undefined;
+    labelVariant?: "stacked" | "floating" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, Omit<VariantProps<typeof inputVariants>, 'labelVariant'> {
+    /** Error message to display below the input */
+    error?: string;
+    /** Helper text to display below the input */
+    helperText?: string;
+    /** Label for the input */
+    label?: string;
+    /**
+     * How the label is rendered.
+     * - `stacked` (default): label above the input.
+     * - `floating`: label rests inside the input like a placeholder and floats
+     *   to the top of the field (staying inside it) when focused or filled.
+     *   Ignores `placeholder`; when `hideLabel` is set, falls back to a
+     *   visually-hidden stacked label.
+     */
+    labelVariant?: 'stacked' | 'floating';
+    /** Whether the label should be visually hidden (still accessible) */
+    hideLabel?: boolean;
+    /** Whether the input is required */
+    required?: boolean;
+    /**
+     * Color of the required asterisk.
+     * - `default`: destructive (hard requirement).
+     * - `warning`: warning color (soft requirement / recommended).
+     */
+    requiredVariant?: RequiredMarkVariant;
+}
+type RequiredMarkVariant = 'default' | 'warning';
 
 type DateInputMode = 'default' | 'dob' | 'expiration' | 'past' | 'future';
 type DateInputType = 'date' | 'datetime-local' | 'time' | 'month' | 'year';

package/dist/components/Dropdown/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkTJCX4OML_cjs = require('../../chunk-TJCX4OML.cjs');
+require('../../chunk-ZNUMOJOI.cjs');
+var chunkC77FAR3F_cjs = require('../../chunk-C77FAR3F.cjs');
 require('../../chunk-I44YNYI6.cjs');
 require('../../chunk-Z5S5JEJD.cjs');
 require('../../chunk-FHY3K6PL.cjs');
@@ -14,31 +15,31 @@ require('../../chunk-EUAMEVVI.cjs');
 
 Object.defineProperty(exports, "Dropdown", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.Dropdown; }
+  get: function () { return chunkC77FAR3F_cjs.Dropdown; }
 });
 Object.defineProperty(exports, "DropdownContent", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownContent; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownContent; }
 });
 Object.defineProperty(exports, "DropdownHeader", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownHeader; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownHeader; }
 });
 Object.defineProperty(exports, "DropdownItem", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownItem; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownItem; }
 });
 Object.defineProperty(exports, "DropdownLabel", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownLabel; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownLabel; }
 });
 Object.defineProperty(exports, "DropdownSeparator", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownSeparator; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownSeparator; }
 });
 Object.defineProperty(exports, "DropdownSubmenu", {
   enumerable: true,
-  get: function () { return chunkTJCX4OML_cjs.DropdownSubmenu; }
+  get: function () { return chunkC77FAR3F_cjs.DropdownSubmenu; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/components/Dropdown/index.js

@@ -1,4 +1,5 @@
-export { Dropdown, DropdownContent, DropdownHeader, DropdownItem, DropdownLabel, DropdownSeparator, DropdownSubmenu } from '../../chunk-E2PBPQGS.js';
+import '../../chunk-AMYFRY7K.js';
+export { Dropdown, DropdownContent, DropdownHeader, DropdownItem, DropdownLabel, DropdownSeparator, DropdownSubmenu } from '../../chunk-EEOGIGIA.js';
 import '../../chunk-6NZXWKUE.js';
 import '../../chunk-3IMM2PM4.js';
 import '../../chunk-T4ME7QCT.js';

package/dist/components/FieldHistory/index.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+var chunkBJ6ABRSQ_cjs = require('../../chunk-BJ6ABRSQ.cjs');
+require('../../chunk-47P5QLX4.cjs');
+require('../../chunk-7IRTD4JT.cjs');
+require('../../chunk-YGA35Z2P.cjs');
+require('../../chunk-P22YCUVM.cjs');
+require('../../chunk-Q3YVLO52.cjs');
+require('../../chunk-GKDHMNUA.cjs');
+require('../../chunk-4NCDU5IG.cjs');
+require('../../chunk-UPWIJC6I.cjs');
+require('../../chunk-I44YNYI6.cjs');
+require('../../chunk-Z5S5JEJD.cjs');
+require('../../chunk-FHY3K6PL.cjs');
+require('../../chunk-FSGEDDF2.cjs');
+require('../../chunk-AOHJILLU.cjs');
+require('../../chunk-EACNRR3C.cjs');
+require('../../chunk-ANMX7YDL.cjs');
+require('../../chunk-DXEPYK3I.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "FieldHistory", {
+  enumerable: true,
+  get: function () { return chunkBJ6ABRSQ_cjs.FieldHistory; }
+});
+Object.defineProperty(exports, "defaultFieldHistoryLabels", {
+  enumerable: true,
+  get: function () { return chunkBJ6ABRSQ_cjs.defaultFieldHistoryLabels; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

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

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

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

@@ -0,0 +1,66 @@
+import * as React from 'react';
+
+type FieldHistoryValue = string | number | boolean | null | undefined;
+interface FieldHistoryActor {
+    name: string;
+    avatarUrl?: string;
+}
+interface FieldHistoryEntry<V = FieldHistoryValue> {
+    id: string;
+    /** Display label of the changed field. */
+    field: string;
+    from?: V;
+    to?: V;
+    /** ISO string or `Date`. */
+    changedAt: string | Date;
+    changedBy?: FieldHistoryActor;
+    /** Where the change came from, e.g. "Import" or "API". */
+    source?: string;
+}
+interface FieldHistoryLabels {
+    loading: string;
+    empty: string;
+    error: string;
+    retry: string;
+    /** Shown in place of a blank value. */
+    emptyValue: string;
+    /** Screen-reader prefix for the old value. */
+    from: string;
+    /** Screen-reader prefix for the new value. */
+    to: string;
+    fieldFilter: string;
+    allFields: string;
+    today: string;
+    yesterday: string;
+    undated: string;
+}
+declare const defaultFieldHistoryLabels: FieldHistoryLabels;
+type FieldHistorySlot = 'toolbar' | 'section' | 'dayHeader' | 'entry' | 'value' | 'state';
+interface FieldHistoryProps<V = FieldHistoryValue> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    items: FieldHistoryEntry<V>[];
+    loading?: boolean;
+    error?: Error | null;
+    onRetry?: () => void;
+    locale?: string;
+    /** IANA zone for day boundaries. Defaults to local. */
+    timeZone?: string;
+    /** Pins "now" for relative times in stories and tests. */
+    now?: Date;
+    /** Field shown first; the user can change it. Omit for all fields. */
+    defaultField?: string;
+    /** Renders a non-empty value, e.g. a currency or a status badge. */
+    formatValue?: (value: V, entry: FieldHistoryEntry<V>) => React.ReactNode;
+    emptyState?: React.ReactNode;
+    labels?: Partial<FieldHistoryLabels>;
+    classNames?: Partial<Record<FieldHistorySlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+/**
+ * The change log of a record's fields, grouped by day. Declared
+ * `parameters.catalog.collection` — its load states are part of the API.
+ */
+declare const FieldHistory: <V = FieldHistoryValue>(props: FieldHistoryProps<V> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => React.ReactElement;
+
+export { FieldHistory, type FieldHistoryActor, type FieldHistoryEntry, type FieldHistoryLabels, type FieldHistoryProps, type FieldHistorySlot, type FieldHistoryValue, defaultFieldHistoryLabels };

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

@@ -0,0 +1,66 @@
+import * as React from 'react';
+
+type FieldHistoryValue = string | number | boolean | null | undefined;
+interface FieldHistoryActor {
+    name: string;
+    avatarUrl?: string;
+}
+interface FieldHistoryEntry<V = FieldHistoryValue> {
+    id: string;
+    /** Display label of the changed field. */
+    field: string;
+    from?: V;
+    to?: V;
+    /** ISO string or `Date`. */
+    changedAt: string | Date;
+    changedBy?: FieldHistoryActor;
+    /** Where the change came from, e.g. "Import" or "API". */
+    source?: string;
+}
+interface FieldHistoryLabels {
+    loading: string;
+    empty: string;
+    error: string;
+    retry: string;
+    /** Shown in place of a blank value. */
+    emptyValue: string;
+    /** Screen-reader prefix for the old value. */
+    from: string;
+    /** Screen-reader prefix for the new value. */
+    to: string;
+    fieldFilter: string;
+    allFields: string;
+    today: string;
+    yesterday: string;
+    undated: string;
+}
+declare const defaultFieldHistoryLabels: FieldHistoryLabels;
+type FieldHistorySlot = 'toolbar' | 'section' | 'dayHeader' | 'entry' | 'value' | 'state';
+interface FieldHistoryProps<V = FieldHistoryValue> extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    items: FieldHistoryEntry<V>[];
+    loading?: boolean;
+    error?: Error | null;
+    onRetry?: () => void;
+    locale?: string;
+    /** IANA zone for day boundaries. Defaults to local. */
+    timeZone?: string;
+    /** Pins "now" for relative times in stories and tests. */
+    now?: Date;
+    /** Field shown first; the user can change it. Omit for all fields. */
+    defaultField?: string;
+    /** Renders a non-empty value, e.g. a currency or a status badge. */
+    formatValue?: (value: V, entry: FieldHistoryEntry<V>) => React.ReactNode;
+    emptyState?: React.ReactNode;
+    labels?: Partial<FieldHistoryLabels>;
+    classNames?: Partial<Record<FieldHistorySlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+/**
+ * The change log of a record's fields, grouped by day. Declared
+ * `parameters.catalog.collection` — its load states are part of the API.
+ */
+declare const FieldHistory: <V = FieldHistoryValue>(props: FieldHistoryProps<V> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => React.ReactElement;
+
+export { FieldHistory, type FieldHistoryActor, type FieldHistoryEntry, type FieldHistoryLabels, type FieldHistoryProps, type FieldHistorySlot, type FieldHistoryValue, defaultFieldHistoryLabels };

package/dist/components/FieldHistory/index.js

@@ -0,0 +1,21 @@
+export { FieldHistory, defaultFieldHistoryLabels } from '../../chunk-6N7NMOSV.js';
+import '../../chunk-YGS2TRMP.js';
+import '../../chunk-Y424YL55.js';
+import '../../chunk-ZIUADGAR.js';
+import '../../chunk-H2Y7HZV5.js';
+import '../../chunk-DVDT7TX7.js';
+import '../../chunk-TI3TQQ7F.js';
+import '../../chunk-3YBS4WUQ.js';
+import '../../chunk-VCI2Y7ST.js';
+import '../../chunk-6NZXWKUE.js';
+import '../../chunk-3IMM2PM4.js';
+import '../../chunk-T4ME7QCT.js';
+import '../../chunk-62ZOA6PX.js';
+import '../../chunk-WSNMQQ4P.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
+//# sourceMappingURL=index.js.map