themelia-ui 1.0.0

package/dist/components/base/popover-menu/popover-menu.d.cts

@@ -0,0 +1,46 @@
+import { ComponentProps, ReactElement, ReactNode } from 'react';
+import { PopoverContent } from '../popover/index.cjs';
+import { PopoverMenuStrings } from './popover-menu.strings.cjs';
+import { PopoverMenuItem } from './popover-menu.types.cjs';
+export interface PopoverMenuProps<T = unknown> {
+    /** The clickable the popover anchors to. */
+    trigger: ReactElement;
+    items: readonly PopoverMenuItem<T>[];
+    onSelect: (item: PopoverMenuItem<T>) => void;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Shows the search field above the list. */
+    search?: boolean;
+    /**
+     * Controlled search value. Supplying `onSearchChange` also hands filtering to the
+     * caller — the local matcher steps aside rather than filtering an already-filtered
+     * list, which is how a server-side search ends up showing nothing.
+     */
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    loading?: boolean;
+    /** Band above the search field. */
+    header?: ReactNode;
+    /** Band below the list — confirm and clear buttons. */
+    footer?: ReactNode;
+    /** Replaces the default no-results copy. */
+    /** A rendered empty state. For plain copy, use `strings.empty`. */
+    empty?: ReactNode;
+    /** Replaces the default spinner strip. */
+    loadingSlot?: ReactNode;
+    /** Overrides this menu's own copy — the filter placeholder and the loading row. */
+    strings?: Partial<PopoverMenuStrings>;
+    /** Full control over a row. */
+    renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
+    align?: ComponentProps<typeof PopoverContent>["align"];
+    sideOffset?: ComponentProps<typeof PopoverContent>["sideOffset"];
+    className?: string;
+}
+/**
+ * The recurring "trigger → optional header → search → list" picker: filter facets,
+ * operator selects, assignee menus.
+ *
+ * For anything outside that shape, compose `Popover` and `Command` directly — this is a
+ * bounded convenience over them, not a replacement.
+ */
+export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, loading, header, footer, empty, loadingSlot, strings, renderItem, align, sideOffset, className, }: PopoverMenuProps<T>): import("react").JSX.Element;

package/dist/components/base/popover-menu/popover-menu.d.ts

@@ -0,0 +1,46 @@
+import { ComponentProps, ReactElement, ReactNode } from 'react';
+import { PopoverContent } from '../popover/index.js';
+import { PopoverMenuStrings } from './popover-menu.strings.js';
+import { PopoverMenuItem } from './popover-menu.types.js';
+export interface PopoverMenuProps<T = unknown> {
+    /** The clickable the popover anchors to. */
+    trigger: ReactElement;
+    items: readonly PopoverMenuItem<T>[];
+    onSelect: (item: PopoverMenuItem<T>) => void;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Shows the search field above the list. */
+    search?: boolean;
+    /**
+     * Controlled search value. Supplying `onSearchChange` also hands filtering to the
+     * caller — the local matcher steps aside rather than filtering an already-filtered
+     * list, which is how a server-side search ends up showing nothing.
+     */
+    searchValue?: string;
+    onSearchChange?: (value: string) => void;
+    loading?: boolean;
+    /** Band above the search field. */
+    header?: ReactNode;
+    /** Band below the list — confirm and clear buttons. */
+    footer?: ReactNode;
+    /** Replaces the default no-results copy. */
+    /** A rendered empty state. For plain copy, use `strings.empty`. */
+    empty?: ReactNode;
+    /** Replaces the default spinner strip. */
+    loadingSlot?: ReactNode;
+    /** Overrides this menu's own copy — the filter placeholder and the loading row. */
+    strings?: Partial<PopoverMenuStrings>;
+    /** Full control over a row. */
+    renderItem?: (item: PopoverMenuItem<T>) => ReactNode;
+    align?: ComponentProps<typeof PopoverContent>["align"];
+    sideOffset?: ComponentProps<typeof PopoverContent>["sideOffset"];
+    className?: string;
+}
+/**
+ * The recurring "trigger → optional header → search → list" picker: filter facets,
+ * operator selects, assignee menus.
+ *
+ * For anything outside that shape, compose `Popover` and `Command` directly — this is a
+ * bounded convenience over them, not a replacement.
+ */
+export declare function PopoverMenu<T = unknown>({ trigger, items, onSelect, open, onOpenChange, search, searchValue, onSearchChange, loading, header, footer, empty, loadingSlot, strings, renderItem, align, sideOffset, className, }: PopoverMenuProps<T>): import("react").JSX.Element;

package/dist/components/base/popover-menu/popover-menu.strings.d.cts

@@ -0,0 +1,9 @@
+export interface PopoverMenuStrings {
+    /** Announced while the items are being fetched. */
+    loading: string;
+    /** Placeholder in the filter field. */
+    searchPlaceholder: string;
+    /** Shown when the filter matches nothing. */
+    empty: string;
+}
+export declare const defaultPopoverMenuStrings: PopoverMenuStrings;

package/dist/components/base/popover-menu/popover-menu.strings.d.ts

@@ -0,0 +1,9 @@
+export interface PopoverMenuStrings {
+    /** Announced while the items are being fetched. */
+    loading: string;
+    /** Placeholder in the filter field. */
+    searchPlaceholder: string;
+    /** Shown when the filter matches nothing. */
+    empty: string;
+}
+export declare const defaultPopoverMenuStrings: PopoverMenuStrings;

package/dist/components/base/popover-menu/popover-menu.types.d.cts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export interface PopoverMenuItem<T = unknown> {
+    /** Unique identifier. Also the match value when no `searchValue` is given. */
+    value: string;
+    label: ReactNode;
+    /** Secondary line under the label. */
+    description?: ReactNode;
+    /** Leading glyph. Takes the accent colour while the row is selected. */
+    icon?: ReactNode;
+    selected?: boolean;
+    disabled?: boolean;
+    /** Match string, for when `label` is a node rather than plain text. */
+    searchValue?: string;
+    /** Arbitrary payload handed back to `onSelect`. */
+    data?: T;
+}

package/dist/components/base/popover-menu/popover-menu.types.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+export interface PopoverMenuItem<T = unknown> {
+    /** Unique identifier. Also the match value when no `searchValue` is given. */
+    value: string;
+    label: ReactNode;
+    /** Secondary line under the label. */
+    description?: ReactNode;
+    /** Leading glyph. Takes the accent colour while the row is selected. */
+    icon?: ReactNode;
+    selected?: boolean;
+    disabled?: boolean;
+    /** Match string, for when `label` is a node rather than plain text. */
+    searchValue?: string;
+    /** Arbitrary payload handed back to `onSelect`. */
+    data?: T;
+}

package/dist/components/base/qr-code/index.d.cts

@@ -0,0 +1,2 @@
+export { QRCode, type QRCodeProps, type QRRobustness } from './qr-code.cjs';
+export { defaultQRCodeStrings, type QRCodeStrings } from './qr-code.strings.cjs';

package/dist/components/base/qr-code/index.d.ts

@@ -0,0 +1,2 @@
+export { QRCode, type QRCodeProps, type QRRobustness } from './qr-code.js';
+export { defaultQRCodeStrings, type QRCodeStrings } from './qr-code.strings.js';

package/dist/components/base/qr-code/qr-code.d.cts

@@ -0,0 +1,32 @@
+import { QRCodeStrings } from './qr-code.strings.cjs';
+import { ComponentProps } from 'react';
+import * as React from "react";
+/**
+ * How much of the symbol can be obscured and still decode: L ≈ 7%, M ≈ 15%, Q ≈ 25%,
+ * H ≈ 30%. Higher costs density — the same payload needs a larger grid.
+ *
+ * Named for the source kit's prop rather than the encoder's `errorCorrectionLevel`.
+ */
+export type QRRobustness = "L" | "M" | "Q" | "H";
+export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
+    /** What the code encodes — a URL, a payment string, a token. */
+    value: string;
+    /** Overrides the dark modules. Defaults to the theme's foreground. */
+    foreground?: string;
+    /** Overrides the light modules. Defaults to the theme's background. */
+    background?: string;
+    robustness?: QRRobustness;
+    /** Shown while encoding. Defaults to this component's own `generating` string. */
+    placeholder?: string;
+    /** Overrides this code's own copy — the two placeholder states and its name. */
+    strings?: Partial<QRCodeStrings>;
+    /**
+     * Shown when `value` is empty. Defaults to rendering nothing, because an empty value
+     * usually means the thing being encoded does not exist yet — a placeholder there
+     * claims something is loading when nothing is.
+     */
+    emptyState?: React.ReactNode;
+    /** Announced in place of the symbol, which is meaningless to a screen reader. */
+    label?: string;
+}
+export declare const QRCode: React.ForwardRefExoticComponent<Omit<QRCodeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/components/base/qr-code/qr-code.d.ts

@@ -0,0 +1,32 @@
+import { QRCodeStrings } from './qr-code.strings.js';
+import { ComponentProps } from 'react';
+import * as React from "react";
+/**
+ * How much of the symbol can be obscured and still decode: L ≈ 7%, M ≈ 15%, Q ≈ 25%,
+ * H ≈ 30%. Higher costs density — the same payload needs a larger grid.
+ *
+ * Named for the source kit's prop rather than the encoder's `errorCorrectionLevel`.
+ */
+export type QRRobustness = "L" | "M" | "Q" | "H";
+export interface QRCodeProps extends Omit<ComponentProps<"div">, "children"> {
+    /** What the code encodes — a URL, a payment string, a token. */
+    value: string;
+    /** Overrides the dark modules. Defaults to the theme's foreground. */
+    foreground?: string;
+    /** Overrides the light modules. Defaults to the theme's background. */
+    background?: string;
+    robustness?: QRRobustness;
+    /** Shown while encoding. Defaults to this component's own `generating` string. */
+    placeholder?: string;
+    /** Overrides this code's own copy — the two placeholder states and its name. */
+    strings?: Partial<QRCodeStrings>;
+    /**
+     * Shown when `value` is empty. Defaults to rendering nothing, because an empty value
+     * usually means the thing being encoded does not exist yet — a placeholder there
+     * claims something is loading when nothing is.
+     */
+    emptyState?: React.ReactNode;
+    /** Announced in place of the symbol, which is meaningless to a screen reader. */
+    label?: string;
+}
+export declare const QRCode: React.ForwardRefExoticComponent<Omit<QRCodeProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/components/base/qr-code/qr-code.strings.d.cts

@@ -0,0 +1,16 @@
+/**
+ * What a QR code says while it has nothing to show.
+ *
+ * Both states were English literals: the placeholder as a default parameter, the failure
+ * as a string inside a ternary — which is why one of them was invisible to a scanner
+ * looking for text between tags.
+ */
+export interface QRCodeStrings {
+    /** While the symbol is being generated. */
+    generating: string;
+    /** When the value cannot be encoded at all. */
+    failed: string;
+    /** Names the rendered symbol, by the value it encodes. */
+    label: (value: string) => string;
+}
+export declare const defaultQRCodeStrings: QRCodeStrings;

package/dist/components/base/qr-code/qr-code.strings.d.ts

@@ -0,0 +1,16 @@
+/**
+ * What a QR code says while it has nothing to show.
+ *
+ * Both states were English literals: the placeholder as a default parameter, the failure
+ * as a string inside a ternary — which is why one of them was invisible to a scanner
+ * looking for text between tags.
+ */
+export interface QRCodeStrings {
+    /** While the symbol is being generated. */
+    generating: string;
+    /** When the value cannot be encoded at all. */
+    failed: string;
+    /** Names the rendered symbol, by the value it encodes. */
+    label: (value: string) => string;
+}
+export declare const defaultQRCodeStrings: QRCodeStrings;

package/dist/components/base/repeaters/index.d.cts

@@ -0,0 +1,8 @@
+export { Repeater, type RepeaterProps, type RepeaterRowContext } from './repeater.cjs';
+export { StringRepeater, type StringRepeaterProps } from './string-repeater.cjs';
+export { KeyValueEditor, type KeyValueEditorProps, type KeyValuePair } from './key-value-editor.cjs';
+export { LocalizedObjectField, LocalizedStringField, type LocaleDescriptor, type LocalizedObjectFieldDefinition, type LocalizedObjectFieldProps, type LocalizedObjectValue, type LocalizedStringFieldProps, type LocalizedValue, } from './localized-fields.cjs';
+export { LocalizedStringRepeater, type LocalizedStringRepeaterProps, } from './localized-string-repeater.cjs';
+export { defaultRepeaterStrings, defaultKeyValueEditorStrings, type RepeaterStrings, type KeyValueEditorStrings, } from './repeaters.strings.cjs';
+export { ObjectRepeater, type ObjectRepeaterProps, type ObjectFieldDef, type ObjectRepeaterFieldContext, type ObjectRow, } from './object-repeater.cjs';
+export { defaultObjectRepeaterStrings, type ObjectRepeaterStrings } from './repeaters.strings.cjs';

package/dist/components/base/repeaters/index.d.ts

@@ -0,0 +1,8 @@
+export { Repeater, type RepeaterProps, type RepeaterRowContext } from './repeater.js';
+export { StringRepeater, type StringRepeaterProps } from './string-repeater.js';
+export { KeyValueEditor, type KeyValueEditorProps, type KeyValuePair } from './key-value-editor.js';
+export { LocalizedObjectField, LocalizedStringField, type LocaleDescriptor, type LocalizedObjectFieldDefinition, type LocalizedObjectFieldProps, type LocalizedObjectValue, type LocalizedStringFieldProps, type LocalizedValue, } from './localized-fields.js';
+export { LocalizedStringRepeater, type LocalizedStringRepeaterProps, } from './localized-string-repeater.js';
+export { defaultRepeaterStrings, defaultKeyValueEditorStrings, type RepeaterStrings, type KeyValueEditorStrings, } from './repeaters.strings.js';
+export { ObjectRepeater, type ObjectRepeaterProps, type ObjectFieldDef, type ObjectRepeaterFieldContext, type ObjectRow, } from './object-repeater.js';
+export { defaultObjectRepeaterStrings, type ObjectRepeaterStrings } from './repeaters.strings.js';

package/dist/components/base/repeaters/key-value-editor.d.cts

@@ -0,0 +1,20 @@
+import { KeyValueEditorStrings } from './repeaters.strings.cjs';
+export interface KeyValuePair {
+    key: string;
+    value: string;
+}
+export interface KeyValueEditorProps {
+    value: KeyValuePair[];
+    onValueChange: (value: KeyValuePair[]) => void;
+    /** Overrides this editor's own copy — the two placeholders, add, and remove. */
+    strings?: Partial<KeyValueEditorStrings>;
+    emptyState?: React.ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Flags a key that is already used elsewhere in the list. */
+    flagDuplicateKeys?: boolean;
+    className?: string;
+}
+export declare function KeyValueEditor({ value, onValueChange, strings, emptyState, maxItems, sortable, disabled, invalid, flagDuplicateKeys, className, }: KeyValueEditorProps): import("react").JSX.Element;

package/dist/components/base/repeaters/key-value-editor.d.ts

@@ -0,0 +1,20 @@
+import { KeyValueEditorStrings } from './repeaters.strings.js';
+export interface KeyValuePair {
+    key: string;
+    value: string;
+}
+export interface KeyValueEditorProps {
+    value: KeyValuePair[];
+    onValueChange: (value: KeyValuePair[]) => void;
+    /** Overrides this editor's own copy — the two placeholders, add, and remove. */
+    strings?: Partial<KeyValueEditorStrings>;
+    emptyState?: React.ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Flags a key that is already used elsewhere in the list. */
+    flagDuplicateKeys?: boolean;
+    className?: string;
+}
+export declare function KeyValueEditor({ value, onValueChange, strings, emptyState, maxItems, sortable, disabled, invalid, flagDuplicateKeys, className, }: KeyValueEditorProps): import("react").JSX.Element;

package/dist/components/base/repeaters/localized-fields.d.cts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+export interface LocaleDescriptor {
+    /** BCP 47 tag — "en", "nl", "pt-BR". */
+    value: string;
+    /** Shown on the switcher. Falls back to the tag. */
+    label?: string;
+}
+/** `{ en: "Name", nl: "Naam" }`. Missing keys are simply untranslated. */
+export type LocalizedValue = Record<string, string>;
+export interface LocalizedStringFieldProps {
+    locales: (string | LocaleDescriptor)[];
+    value?: LocalizedValue;
+    onValueChange?: (value: LocalizedValue) => void;
+    /** A textarea per locale rather than an input. */
+    multiline?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks locales that must be filled, so the switcher can flag what is missing. */
+    requiredLocales?: string[];
+    className?: string;
+    "aria-label"?: string;
+}
+export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, }: LocalizedStringFieldProps): import("react").JSX.Element;
+export interface LocalizedObjectFieldDefinition {
+    /** Key in each locale's object. */
+    name: string;
+    label: ReactNode;
+    multiline?: boolean;
+    placeholder?: string;
+}
+/** `{ en: { title: "…", body: "…" }, nl: { … } }`. */
+export type LocalizedObjectValue = Record<string, Record<string, string>>;
+export interface LocalizedObjectFieldProps {
+    locales: (string | LocaleDescriptor)[];
+    /** The fields inside each locale. */
+    fields: LocalizedObjectFieldDefinition[];
+    value?: LocalizedObjectValue;
+    onValueChange?: (value: LocalizedObjectValue) => void;
+    disabled?: boolean;
+    invalid?: boolean;
+    className?: string;
+}
+/** Several fields per locale — a title and a body, say — behind one switcher. */
+export declare function LocalizedObjectField({ locales, fields, value, onValueChange, disabled, invalid, className, }: LocalizedObjectFieldProps): import("react").JSX.Element;

package/dist/components/base/repeaters/localized-fields.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+export interface LocaleDescriptor {
+    /** BCP 47 tag — "en", "nl", "pt-BR". */
+    value: string;
+    /** Shown on the switcher. Falls back to the tag. */
+    label?: string;
+}
+/** `{ en: "Name", nl: "Naam" }`. Missing keys are simply untranslated. */
+export type LocalizedValue = Record<string, string>;
+export interface LocalizedStringFieldProps {
+    locales: (string | LocaleDescriptor)[];
+    value?: LocalizedValue;
+    onValueChange?: (value: LocalizedValue) => void;
+    /** A textarea per locale rather than an input. */
+    multiline?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Marks locales that must be filled, so the switcher can flag what is missing. */
+    requiredLocales?: string[];
+    className?: string;
+    "aria-label"?: string;
+}
+export declare function LocalizedStringField({ locales, value, onValueChange, multiline, placeholder, disabled, invalid, requiredLocales, className, "aria-label": ariaLabel, }: LocalizedStringFieldProps): import("react").JSX.Element;
+export interface LocalizedObjectFieldDefinition {
+    /** Key in each locale's object. */
+    name: string;
+    label: ReactNode;
+    multiline?: boolean;
+    placeholder?: string;
+}
+/** `{ en: { title: "…", body: "…" }, nl: { … } }`. */
+export type LocalizedObjectValue = Record<string, Record<string, string>>;
+export interface LocalizedObjectFieldProps {
+    locales: (string | LocaleDescriptor)[];
+    /** The fields inside each locale. */
+    fields: LocalizedObjectFieldDefinition[];
+    value?: LocalizedObjectValue;
+    onValueChange?: (value: LocalizedObjectValue) => void;
+    disabled?: boolean;
+    invalid?: boolean;
+    className?: string;
+}
+/** Several fields per locale — a title and a body, say — behind one switcher. */
+export declare function LocalizedObjectField({ locales, fields, value, onValueChange, disabled, invalid, className, }: LocalizedObjectFieldProps): import("react").JSX.Element;

package/dist/components/base/repeaters/localized-string-repeater.d.cts

@@ -0,0 +1,20 @@
+import { RepeaterStrings } from './repeaters.strings.cjs';
+import { LocaleDescriptor, LocalizedValue } from './localized-fields.cjs';
+export interface LocalizedStringRepeaterProps {
+    locales: (string | LocaleDescriptor)[];
+    value: LocalizedValue[];
+    onValueChange: (value: LocalizedValue[]) => void;
+    placeholder?: string;
+    /** Overrides this list's own copy — the add control and each row's remove. */
+    strings?: Partial<RepeaterStrings>;
+    emptyState?: React.ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    multiline?: boolean;
+    requiredLocales?: string[];
+    disabled?: boolean;
+    invalid?: boolean;
+    className?: string;
+    "aria-label"?: string;
+}
+export declare function LocalizedStringRepeater({ locales, value, onValueChange, placeholder, strings, emptyState, maxItems, sortable, multiline, requiredLocales, disabled, invalid, className, "aria-label": ariaLabel, }: LocalizedStringRepeaterProps): import("react").JSX.Element;

package/dist/components/base/repeaters/localized-string-repeater.d.ts

@@ -0,0 +1,20 @@
+import { RepeaterStrings } from './repeaters.strings.js';
+import { LocaleDescriptor, LocalizedValue } from './localized-fields.js';
+export interface LocalizedStringRepeaterProps {
+    locales: (string | LocaleDescriptor)[];
+    value: LocalizedValue[];
+    onValueChange: (value: LocalizedValue[]) => void;
+    placeholder?: string;
+    /** Overrides this list's own copy — the add control and each row's remove. */
+    strings?: Partial<RepeaterStrings>;
+    emptyState?: React.ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    multiline?: boolean;
+    requiredLocales?: string[];
+    disabled?: boolean;
+    invalid?: boolean;
+    className?: string;
+    "aria-label"?: string;
+}
+export declare function LocalizedStringRepeater({ locales, value, onValueChange, placeholder, strings, emptyState, maxItems, sortable, multiline, requiredLocales, disabled, invalid, className, "aria-label": ariaLabel, }: LocalizedStringRepeaterProps): import("react").JSX.Element;

package/dist/components/base/repeaters/object-repeater.d.cts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { ObjectRepeaterStrings } from './repeaters.strings.cjs';
+export interface ObjectFieldDef {
+    /** Key within each row object. */
+    name: string;
+    label: string;
+    /** `textarea` for prose; `number` narrows the keyboard on a phone. */
+    type?: "text" | "textarea" | "number";
+    placeholder?: string;
+    required?: boolean;
+    /** A line under the field. */
+    hint?: string;
+    /** Fraction of the row this field takes, 1–12. Defaults to an even share. */
+    span?: number;
+}
+export interface ObjectRepeaterFieldContext {
+    index: number;
+    /** `items.2.email` — the path this field would have in a form library. */
+    path: string;
+    value: string;
+    onChange: (value: string) => void;
+    invalid: boolean;
+    disabled: boolean;
+}
+export type ObjectRow = Record<string, string>;
+export interface ObjectRepeaterProps {
+    value: ObjectRow[];
+    onValueChange: (value: ObjectRow[]) => void;
+    fields: ObjectFieldDef[];
+    /**
+     * Prefixes the generated field paths, so they match the shape a form library expects.
+     * Purely a naming aid — this component reads and writes the array it is given.
+     */
+    name?: string;
+    emptyState?: ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Replaces one field's control, keeping the row and array behaviour. */
+    renderField?: (field: ObjectFieldDef, context: ObjectRepeaterFieldContext) => ReactNode;
+    strings?: Partial<ObjectRepeaterStrings>;
+    className?: string;
+}
+export declare function ObjectRepeater({ value, onValueChange, fields, name, emptyState, maxItems, sortable, disabled, invalid, renderField, strings, className, }: ObjectRepeaterProps): import("react").JSX.Element;

package/dist/components/base/repeaters/object-repeater.d.ts

@@ -0,0 +1,45 @@
+import { ReactNode } from 'react';
+import { ObjectRepeaterStrings } from './repeaters.strings.js';
+export interface ObjectFieldDef {
+    /** Key within each row object. */
+    name: string;
+    label: string;
+    /** `textarea` for prose; `number` narrows the keyboard on a phone. */
+    type?: "text" | "textarea" | "number";
+    placeholder?: string;
+    required?: boolean;
+    /** A line under the field. */
+    hint?: string;
+    /** Fraction of the row this field takes, 1–12. Defaults to an even share. */
+    span?: number;
+}
+export interface ObjectRepeaterFieldContext {
+    index: number;
+    /** `items.2.email` — the path this field would have in a form library. */
+    path: string;
+    value: string;
+    onChange: (value: string) => void;
+    invalid: boolean;
+    disabled: boolean;
+}
+export type ObjectRow = Record<string, string>;
+export interface ObjectRepeaterProps {
+    value: ObjectRow[];
+    onValueChange: (value: ObjectRow[]) => void;
+    fields: ObjectFieldDef[];
+    /**
+     * Prefixes the generated field paths, so they match the shape a form library expects.
+     * Purely a naming aid — this component reads and writes the array it is given.
+     */
+    name?: string;
+    emptyState?: ReactNode;
+    maxItems?: number;
+    sortable?: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+    /** Replaces one field's control, keeping the row and array behaviour. */
+    renderField?: (field: ObjectFieldDef, context: ObjectRepeaterFieldContext) => ReactNode;
+    strings?: Partial<ObjectRepeaterStrings>;
+    className?: string;
+}
+export declare function ObjectRepeater({ value, onValueChange, fields, name, emptyState, maxItems, sortable, disabled, invalid, renderField, strings, className, }: ObjectRepeaterProps): import("react").JSX.Element;

package/dist/components/base/repeaters/repeater.d.cts

@@ -0,0 +1,29 @@
+import { ReactNode } from 'react';
+import { RepeaterStrings } from './repeaters.strings.cjs';
+export interface RepeaterRowContext {
+    index: number;
+    /** True while this row is the one being dragged. */
+    dragging: boolean;
+}
+export interface RepeaterProps<T> {
+    items: T[];
+    /** Stable key for a row. An index is a poor key while rows reorder. */
+    getKey: (item: T, index: number) => string;
+    children: (item: T, context: RepeaterRowContext) => ReactNode;
+    onAdd?: () => void;
+    onRemove?: (index: number) => void;
+    /** Enables reordering. Without it, no handle is rendered. */
+    onMove?: (from: number, to: number) => void;
+    /** `card` wraps each row in a bordered surface, for multi-field rows. */
+    rowVariant?: "inline" | "card";
+    /** Overrides this list's own copy — the add control and each row's remove. */
+    strings?: Partial<RepeaterStrings>;
+    emptyState?: ReactNode;
+    /** Hides the add button, for a list with a fixed set of rows. */
+    showAdd?: boolean;
+    /** Caps the list. The add button disables at the limit. */
+    maxItems?: number;
+    disabled?: boolean;
+    className?: string;
+}
+export declare function Repeater<T>({ items, getKey, children, onAdd, onRemove, onMove, rowVariant, strings, emptyState, showAdd, maxItems, disabled, className, }: RepeaterProps<T>): import("react").JSX.Element;

package/dist/components/base/repeaters/repeater.d.ts

@@ -0,0 +1,29 @@
+import { ReactNode } from 'react';
+import { RepeaterStrings } from './repeaters.strings.js';
+export interface RepeaterRowContext {
+    index: number;
+    /** True while this row is the one being dragged. */
+    dragging: boolean;
+}
+export interface RepeaterProps<T> {
+    items: T[];
+    /** Stable key for a row. An index is a poor key while rows reorder. */
+    getKey: (item: T, index: number) => string;
+    children: (item: T, context: RepeaterRowContext) => ReactNode;
+    onAdd?: () => void;
+    onRemove?: (index: number) => void;
+    /** Enables reordering. Without it, no handle is rendered. */
+    onMove?: (from: number, to: number) => void;
+    /** `card` wraps each row in a bordered surface, for multi-field rows. */
+    rowVariant?: "inline" | "card";
+    /** Overrides this list's own copy — the add control and each row's remove. */
+    strings?: Partial<RepeaterStrings>;
+    emptyState?: ReactNode;
+    /** Hides the add button, for a list with a fixed set of rows. */
+    showAdd?: boolean;
+    /** Caps the list. The add button disables at the limit. */
+    maxItems?: number;
+    disabled?: boolean;
+    className?: string;
+}
+export declare function Repeater<T>({ items, getKey, children, onAdd, onRemove, onMove, rowVariant, strings, emptyState, showAdd, maxItems, disabled, className, }: RepeaterProps<T>): import("react").JSX.Element;

package/dist/components/base/repeaters/repeaters.strings.d.cts

@@ -0,0 +1,38 @@
+export interface RepeaterStrings {
+    /** The control that appends a row. */
+    add: string;
+    /**
+     * Names the row's remove control, by the row it removes.
+     *
+     * A function rather than a bare label, because every remove button in a list saying
+     * the same thing is a column of controls a screen reader cannot tell apart — and
+     * because "Remove item 3" does not reorder cleanly into every language.
+     */
+    remove: (index: number) => string;
+    /**
+     * Names the drag handle, and says how to use it without a pointer.
+     *
+     * The instruction is part of the sentence rather than a separate key, because a
+     * language that puts it first has no way to reassemble two halves in the right order.
+     */
+    reorder: (index: number) => string;
+}
+export declare const defaultRepeaterStrings: RepeaterStrings;
+export interface KeyValueEditorStrings extends RepeaterStrings {
+    keyPlaceholder: string;
+    valuePlaceholder: string;
+    /**
+     * Names each field by its row, so a column of them can be told apart.
+     *
+     * The placeholder cannot do this job: it names the KIND of field, and every row's is
+     * identical. A screen reader moving down the column heard "Key" eleven times.
+     */
+    keyLabel: (index: number) => string;
+    valueLabel: (index: number) => string;
+}
+export declare const defaultKeyValueEditorStrings: KeyValueEditorStrings;
+export interface ObjectRepeaterStrings extends RepeaterStrings {
+    /** Shown when the list is empty. */
+    emptyState: string;
+}
+export declare const defaultObjectRepeaterStrings: ObjectRepeaterStrings;