themelia-ui 1.0.0

package/dist/components/base/structure/structure.types.d.ts

@@ -0,0 +1,23 @@
+import { ComponentScale } from '../../../lib/component-vocabulary.js';
+export type { Breakpoint as StructureBreakpoint, ResponsiveValue } from '../../../lib/responsive.js';
+export type StructureGap = "none" | "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
+export type StructureAlign = "start" | "center" | "end" | "stretch" | "baseline";
+export type StructureJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
+export type StructureDirection = "vertical" | "horizontal";
+export type GridColumns = 1 | 2 | 3 | 4;
+export type GridSpan = GridColumns | "full";
+export type AdaptiveGridMinimum = ComponentScale;
+/**
+ * A width step, or any CSS length.
+ *
+ * The named steps are the page-content measures the kit already ships
+ * (`--content-width-*`). A raw length is deliberately allowed beside them: a field is
+ * about 26rem and a rail about 16rem, and those are control measures rather than content
+ * measures — inventing scale names for them would put two different scales in one word.
+ */
+export type StructureWidth = "sm" | "md" | "lg" | "xl" | "2xl" | "full" | "none";
+/** The axis a `Bleed` escapes on. */
+export type BleedAxis = "inline" | "block" | "both";
+/** Which side of a `Split` holds the fixed column. */
+export type SplitSide = "start" | "end";
+export declare const STRUCTURE_BREAKPOINTS: import('../../../lib/responsive.js').Breakpoint[];

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

@@ -0,0 +1,2 @@
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableEmpty, } from './table.cjs';
+export type { TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableSortDirection, } from './table.cjs';

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

@@ -0,0 +1,2 @@
+export { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableEmpty, } from './table.js';
+export type { TableAlign, TableCellProps, TableEmptyProps, TableHeadProps, TableProps, TableSortDirection, } from './table.js';

package/dist/components/base/table/table.d.cts

@@ -0,0 +1,51 @@
+import { ComponentProps, ReactNode } from 'react';
+/** Column alignment. Numeric columns read wrong anywhere but the end. */
+export type TableAlign = "start" | "center" | "end";
+export interface TableProps extends ComponentProps<"table"> {
+    /** Class for the scroll container rather than the `<table>` itself. */
+    containerClassName?: string;
+    /**
+     * Pins the header while the body scrolls.
+     *
+     * Only meaningful when the container is bounded — a table in an unbounded page scrolls
+     * the page, not the container, and there is nothing for the header to stick inside.
+     */
+    stickyHeader?: boolean;
+}
+/** Which way a sorted column is ordered. `null` is "sortable, but not the sort column". */
+export type TableSortDirection = "ascending" | "descending" | null;
+export interface TableCellProps extends Omit<ComponentProps<"td">, "align"> {
+    align?: TableAlign;
+    /** Allows the cell to wrap. Cells are nowrap by default so columns stay readable. */
+    wrap?: boolean;
+}
+export interface TableHeadProps extends Omit<ComponentProps<"th">, "align"> {
+    align?: TableAlign;
+    wrap?: boolean;
+    /** Renders the label as a sort control. Pair with `sortDirection` and `onSort`. */
+    sortable?: boolean;
+    /** This column's current direction, or `null` when another column is the sort. */
+    sortDirection?: TableSortDirection;
+    onSort?: () => void;
+}
+export declare function Table({ className, containerClassName, stickyHeader, ...props }: TableProps): import("react").JSX.Element;
+export declare function TableHeader({ className, ...props }: ComponentProps<"thead">): import("react").JSX.Element;
+export declare function TableBody({ className, ...props }: ComponentProps<"tbody">): import("react").JSX.Element;
+export declare function TableFooter({ className, ...props }: ComponentProps<"tfoot">): import("react").JSX.Element;
+export declare function TableRow({ className, ...props }: ComponentProps<"tr">): import("react").JSX.Element;
+export declare function TableHead({ className, children, align, wrap, sortable, sortDirection, onSort, ...props }: TableHeadProps): import("react").JSX.Element;
+export declare function TableCell({ className, children, align, wrap, ...props }: TableCellProps): import("react").JSX.Element;
+export interface TableEmptyProps extends Omit<ComponentProps<"td">, "children"> {
+    /** How many columns the table has, so the message spans all of them. */
+    colSpan: number;
+    children?: ReactNode;
+}
+/**
+ * The "no rows" row.
+ *
+ * A table that renders an empty `<tbody>` looks broken rather than empty — the header
+ * hangs over nothing and the reader cannot tell a filter that matched nothing from a
+ * request that failed.
+ */
+export declare function TableEmpty({ className, colSpan, children, ...props }: TableEmptyProps): import("react").JSX.Element;
+export declare function TableCaption({ className, children, ...props }: ComponentProps<"caption">): import("react").JSX.Element;

package/dist/components/base/table/table.d.ts

@@ -0,0 +1,51 @@
+import { ComponentProps, ReactNode } from 'react';
+/** Column alignment. Numeric columns read wrong anywhere but the end. */
+export type TableAlign = "start" | "center" | "end";
+export interface TableProps extends ComponentProps<"table"> {
+    /** Class for the scroll container rather than the `<table>` itself. */
+    containerClassName?: string;
+    /**
+     * Pins the header while the body scrolls.
+     *
+     * Only meaningful when the container is bounded — a table in an unbounded page scrolls
+     * the page, not the container, and there is nothing for the header to stick inside.
+     */
+    stickyHeader?: boolean;
+}
+/** Which way a sorted column is ordered. `null` is "sortable, but not the sort column". */
+export type TableSortDirection = "ascending" | "descending" | null;
+export interface TableCellProps extends Omit<ComponentProps<"td">, "align"> {
+    align?: TableAlign;
+    /** Allows the cell to wrap. Cells are nowrap by default so columns stay readable. */
+    wrap?: boolean;
+}
+export interface TableHeadProps extends Omit<ComponentProps<"th">, "align"> {
+    align?: TableAlign;
+    wrap?: boolean;
+    /** Renders the label as a sort control. Pair with `sortDirection` and `onSort`. */
+    sortable?: boolean;
+    /** This column's current direction, or `null` when another column is the sort. */
+    sortDirection?: TableSortDirection;
+    onSort?: () => void;
+}
+export declare function Table({ className, containerClassName, stickyHeader, ...props }: TableProps): import("react").JSX.Element;
+export declare function TableHeader({ className, ...props }: ComponentProps<"thead">): import("react").JSX.Element;
+export declare function TableBody({ className, ...props }: ComponentProps<"tbody">): import("react").JSX.Element;
+export declare function TableFooter({ className, ...props }: ComponentProps<"tfoot">): import("react").JSX.Element;
+export declare function TableRow({ className, ...props }: ComponentProps<"tr">): import("react").JSX.Element;
+export declare function TableHead({ className, children, align, wrap, sortable, sortDirection, onSort, ...props }: TableHeadProps): import("react").JSX.Element;
+export declare function TableCell({ className, children, align, wrap, ...props }: TableCellProps): import("react").JSX.Element;
+export interface TableEmptyProps extends Omit<ComponentProps<"td">, "children"> {
+    /** How many columns the table has, so the message spans all of them. */
+    colSpan: number;
+    children?: ReactNode;
+}
+/**
+ * The "no rows" row.
+ *
+ * A table that renders an empty `<tbody>` looks broken rather than empty — the header
+ * hangs over nothing and the reader cannot tell a filter that matched nothing from a
+ * request that failed.
+ */
+export declare function TableEmpty({ className, colSpan, children, ...props }: TableEmptyProps): import("react").JSX.Element;
+export declare function TableCaption({ className, children, ...props }: ComponentProps<"caption">): import("react").JSX.Element;

package/dist/components/base/text-inputs/field-shell.d.cts

@@ -0,0 +1,24 @@
+/**
+ * FieldShell — a control with inline affordances.
+ *
+ * The shell wears the field surface and the control inside gives up its own, so a leading
+ * icon or a trailing action reads as part of one field rather than a box inside a box.
+ * That handover is in styles/fields.css, keyed off `data-field-shell`.
+ */
+import * as React from "react";
+/** Wiring forwarded through the shell to its actual control. */
+export interface FieldShellControlProps {
+    id?: string;
+    "aria-invalid"?: React.AriaAttributes["aria-invalid"];
+    "aria-describedby"?: React.AriaAttributes["aria-describedby"];
+    "aria-required"?: React.AriaAttributes["aria-required"];
+}
+export interface FieldShellProps extends Omit<React.ComponentProps<"div">, "children"> {
+    /** Rendered before the control — an icon, a prefix, a currency symbol. */
+    start?: React.ReactNode;
+    /** Rendered after the control — a unit, a clear button, a reveal toggle. */
+    end?: React.ReactNode;
+    /** A direct control, or an explicit adapter for a wrapped/custom control. */
+    children?: React.ReactNode | ((controlProps: FieldShellControlProps) => React.ReactNode);
+}
+export declare function FieldShell({ start, end, className, children, id, "aria-invalid": ariaInvalid, "aria-describedby": ariaDescribedBy, "aria-required": ariaRequired, ...props }: FieldShellProps): React.JSX.Element;

package/dist/components/base/text-inputs/field-shell.d.ts

@@ -0,0 +1,24 @@
+/**
+ * FieldShell — a control with inline affordances.
+ *
+ * The shell wears the field surface and the control inside gives up its own, so a leading
+ * icon or a trailing action reads as part of one field rather than a box inside a box.
+ * That handover is in styles/fields.css, keyed off `data-field-shell`.
+ */
+import * as React from "react";
+/** Wiring forwarded through the shell to its actual control. */
+export interface FieldShellControlProps {
+    id?: string;
+    "aria-invalid"?: React.AriaAttributes["aria-invalid"];
+    "aria-describedby"?: React.AriaAttributes["aria-describedby"];
+    "aria-required"?: React.AriaAttributes["aria-required"];
+}
+export interface FieldShellProps extends Omit<React.ComponentProps<"div">, "children"> {
+    /** Rendered before the control — an icon, a prefix, a currency symbol. */
+    start?: React.ReactNode;
+    /** Rendered after the control — a unit, a clear button, a reveal toggle. */
+    end?: React.ReactNode;
+    /** A direct control, or an explicit adapter for a wrapped/custom control. */
+    children?: React.ReactNode | ((controlProps: FieldShellControlProps) => React.ReactNode);
+}
+export declare function FieldShell({ start, end, className, children, id, "aria-invalid": ariaInvalid, "aria-describedby": ariaDescribedBy, "aria-required": ariaRequired, ...props }: FieldShellProps): React.JSX.Element;

package/dist/components/base/text-inputs/index.d.cts

@@ -0,0 +1,11 @@
+export { Input, type FieldIcon, type InputProps } from './input.cjs';
+export { defaultInputStrings, type InputStrings } from './input.strings.cjs';
+export { useFieldValue, type UseFieldValueOptions, type UseFieldValueResult } from './use-field-value.cjs';
+export { Textarea, type TextareaProps } from './textarea.cjs';
+export { FieldShell, type FieldShellControlProps, type FieldShellProps, } from './field-shell.cjs';
+export { PasswordInput, type PasswordInputProps } from './password-input.cjs';
+export { SearchInput, type SearchInputProps } from './search-input.cjs';
+export { NativeSelect, type NativeSelectProps } from './native-select.cjs';
+export { SlugField, type SlugFieldProps } from './slug-field.cjs';
+export { slugify, type SlugifyOptions } from './slugify.cjs';
+export { defaultPasswordInputStrings, type PasswordInputStrings, } from './password-input.strings.cjs';

package/dist/components/base/text-inputs/index.d.ts

@@ -0,0 +1,11 @@
+export { Input, type FieldIcon, type InputProps } from './input.js';
+export { defaultInputStrings, type InputStrings } from './input.strings.js';
+export { useFieldValue, type UseFieldValueOptions, type UseFieldValueResult } from './use-field-value.js';
+export { Textarea, type TextareaProps } from './textarea.js';
+export { FieldShell, type FieldShellControlProps, type FieldShellProps, } from './field-shell.js';
+export { PasswordInput, type PasswordInputProps } from './password-input.js';
+export { SearchInput, type SearchInputProps } from './search-input.js';
+export { NativeSelect, type NativeSelectProps } from './native-select.js';
+export { SlugField, type SlugFieldProps } from './slug-field.js';
+export { slugify, type SlugifyOptions } from './slugify.js';
+export { defaultPasswordInputStrings, type PasswordInputStrings, } from './password-input.strings.js';

package/dist/components/base/text-inputs/input.d.cts

@@ -0,0 +1,37 @@
+import { StringsProp } from '../../../lib/strings.cjs';
+import { InputStrings } from './input.strings.cjs';
+import * as React from "react";
+/** A Lucide icon, any component taking a className, or an already-rendered node. */
+export type FieldIcon = React.ComponentType<{
+    className?: string;
+}> | React.ReactNode;
+export interface InputProps extends Omit<React.ComponentProps<"input">, "size"> {
+    /** Glyph before the value. */
+    startIcon?: FieldIcon;
+    /** Glyph after the value. */
+    endIcon?: FieldIcon;
+    /** Short text before the value — a currency symbol, a protocol, an @. */
+    startAddon?: React.ReactNode;
+    /** Short text after the value — a unit, a domain. */
+    endAddon?: React.ReactNode;
+    /** Shows "12 / 80" in the trailing lane. Requires `maxLength`. */
+    showCharacterCount?: boolean;
+    /** Shows a clear control once the field has a value. */
+    clearable?: boolean;
+    /** Called after the clear control empties the field. */
+    onClear?: () => void;
+    /** Replaces the trailing affordance with a spinner. */
+    loading?: boolean;
+    /** Applies the invalid treatment. The message stays with FormField. */
+    invalid?: boolean;
+    /**
+     * Includes the addons in the value reported by `onChange`.
+     *
+     * Off by default: an addon is presentation, and a caller that stores "$" + the number
+     * has to strip it again on the way out. Turn it on only when the addon really is part
+     * of the value the server expects.
+     */
+    returnValueWithAddons?: boolean;
+    strings?: StringsProp<InputStrings>;
+}
+export declare const Input: React.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/input.d.ts

@@ -0,0 +1,37 @@
+import { StringsProp } from '../../../lib/strings.js';
+import { InputStrings } from './input.strings.js';
+import * as React from "react";
+/** A Lucide icon, any component taking a className, or an already-rendered node. */
+export type FieldIcon = React.ComponentType<{
+    className?: string;
+}> | React.ReactNode;
+export interface InputProps extends Omit<React.ComponentProps<"input">, "size"> {
+    /** Glyph before the value. */
+    startIcon?: FieldIcon;
+    /** Glyph after the value. */
+    endIcon?: FieldIcon;
+    /** Short text before the value — a currency symbol, a protocol, an @. */
+    startAddon?: React.ReactNode;
+    /** Short text after the value — a unit, a domain. */
+    endAddon?: React.ReactNode;
+    /** Shows "12 / 80" in the trailing lane. Requires `maxLength`. */
+    showCharacterCount?: boolean;
+    /** Shows a clear control once the field has a value. */
+    clearable?: boolean;
+    /** Called after the clear control empties the field. */
+    onClear?: () => void;
+    /** Replaces the trailing affordance with a spinner. */
+    loading?: boolean;
+    /** Applies the invalid treatment. The message stays with FormField. */
+    invalid?: boolean;
+    /**
+     * Includes the addons in the value reported by `onChange`.
+     *
+     * Off by default: an addon is presentation, and a caller that stores "$" + the number
+     * has to strip it again on the way out. Turn it on only when the addon really is part
+     * of the value the server expects.
+     */
+    returnValueWithAddons?: boolean;
+    strings?: StringsProp<InputStrings>;
+}
+export declare const Input: React.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/input.strings.d.cts

@@ -0,0 +1,7 @@
+export interface InputStrings {
+    /** Accessible name for the inline clear action. */
+    clear: string;
+    /** Accessible description of the character counter, e.g. "12 of 80 characters". */
+    characterCount: (used: number, limit: number) => string;
+}
+export declare const defaultInputStrings: InputStrings;

package/dist/components/base/text-inputs/input.strings.d.ts

@@ -0,0 +1,7 @@
+export interface InputStrings {
+    /** Accessible name for the inline clear action. */
+    clear: string;
+    /** Accessible description of the character counter, e.g. "12 of 80 characters". */
+    characterCount: (used: number, limit: number) => string;
+}
+export declare const defaultInputStrings: InputStrings;

package/dist/components/base/text-inputs/native-select.d.cts

@@ -0,0 +1,6 @@
+import * as React from "react";
+export interface NativeSelectProps extends Omit<React.ComponentProps<"select">, "size"> {
+    /** Shown as a disabled first option when the value is empty. */
+    placeholder?: string;
+}
+export declare const NativeSelect: React.ForwardRefExoticComponent<Omit<NativeSelectProps, "ref"> & React.RefAttributes<HTMLSelectElement>>;

package/dist/components/base/text-inputs/native-select.d.ts

@@ -0,0 +1,6 @@
+import * as React from "react";
+export interface NativeSelectProps extends Omit<React.ComponentProps<"select">, "size"> {
+    /** Shown as a disabled first option when the value is empty. */
+    placeholder?: string;
+}
+export declare const NativeSelect: React.ForwardRefExoticComponent<Omit<NativeSelectProps, "ref"> & React.RefAttributes<HTMLSelectElement>>;

package/dist/components/base/text-inputs/password-input.d.cts

@@ -0,0 +1,15 @@
+import { InputProps } from './input.cjs';
+import { PasswordInputStrings } from './password-input.strings.cjs';
+/**
+ * PasswordInput — a password field with a reveal toggle.
+ *
+ * The toggle is a real button inside the shell, announced by its label, rather than an
+ * icon with a click handler. `aria-pressed` reports the current state so the announcement
+ * says whether the password is currently visible, not just that a toggle exists.
+ */
+import * as React from "react";
+export interface PasswordInputProps extends Omit<InputProps, "type"> {
+    /** Overrides this field's own copy — the reveal control's name in each state. */
+    strings?: Partial<PasswordInputStrings>;
+}
+export declare const PasswordInput: React.ForwardRefExoticComponent<Omit<PasswordInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/password-input.d.ts

@@ -0,0 +1,15 @@
+import { InputProps } from './input.js';
+import { PasswordInputStrings } from './password-input.strings.js';
+/**
+ * PasswordInput — a password field with a reveal toggle.
+ *
+ * The toggle is a real button inside the shell, announced by its label, rather than an
+ * icon with a click handler. `aria-pressed` reports the current state so the announcement
+ * says whether the password is currently visible, not just that a toggle exists.
+ */
+import * as React from "react";
+export interface PasswordInputProps extends Omit<InputProps, "type"> {
+    /** Overrides this field's own copy — the reveal control's name in each state. */
+    strings?: Partial<PasswordInputStrings>;
+}
+export declare const PasswordInput: React.ForwardRefExoticComponent<Omit<PasswordInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/password-input.strings.d.cts

@@ -0,0 +1,9 @@
+import { InputStrings } from './input.strings.cjs';
+/** Extends the input strings, because the props extend Input's — see forms-numeric. */
+export interface PasswordInputStrings extends InputStrings {
+    /** The reveal control's name in each state. It changes, because the name IS the
+     *  state for someone who cannot see the field. */
+    reveal: string;
+    hide: string;
+}
+export declare const defaultPasswordInputStrings: PasswordInputStrings;

package/dist/components/base/text-inputs/password-input.strings.d.ts

@@ -0,0 +1,9 @@
+import { InputStrings } from './input.strings.js';
+/** Extends the input strings, because the props extend Input's — see forms-numeric. */
+export interface PasswordInputStrings extends InputStrings {
+    /** The reveal control's name in each state. It changes, because the name IS the
+     *  state for someone who cannot see the field. */
+    reveal: string;
+    hide: string;
+}
+export declare const defaultPasswordInputStrings: PasswordInputStrings;

package/dist/components/base/text-inputs/search-input.d.cts

@@ -0,0 +1,7 @@
+import { InputProps } from './input.cjs';
+import * as React from "react";
+export interface SearchInputProps extends Omit<InputProps, "type" | "startIcon"> {
+    /** Called when the reader clears the field. Also what makes the control appear. */
+    onClear?: () => void;
+}
+export declare const SearchInput: React.ForwardRefExoticComponent<Omit<SearchInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/search-input.d.ts

@@ -0,0 +1,7 @@
+import { InputProps } from './input.js';
+import * as React from "react";
+export interface SearchInputProps extends Omit<InputProps, "type" | "startIcon"> {
+    /** Called when the reader clears the field. Also what makes the control appear. */
+    onClear?: () => void;
+}
+export declare const SearchInput: React.ForwardRefExoticComponent<Omit<SearchInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/slug-field.d.cts

@@ -0,0 +1,20 @@
+import { InputProps } from './input.cjs';
+import { SlugifyOptions } from './slugify.cjs';
+/**
+ * SlugField — a read-only mirror of another field, slugified.
+ *
+ * Read-only rather than editable-with-sync: a slug that the user can edit and that also
+ * follows the title has to decide which wins on every keystroke, and every answer to that
+ * surprises someone. This one always follows. A screen that needs a hand-written slug
+ * should use a plain Input.
+ */
+import * as React from "react";
+export interface SlugFieldProps extends Omit<InputProps, "value" | "defaultValue" | "onChange" | "readOnly" | "type" | "prefix">, SlugifyOptions {
+    /** The source value. Controlled — the slug is derived, never held. */
+    value: string | number | null | undefined;
+    /** Replaces the built-in derivation entirely. */
+    transform?: (value: string | number | null | undefined) => string;
+    /** Rendered before the slug, inside the field — a domain or a path prefix. */
+    prefix?: React.ReactNode;
+}
+export declare const SlugField: React.ForwardRefExoticComponent<Omit<SlugFieldProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/slug-field.d.ts

@@ -0,0 +1,20 @@
+import { InputProps } from './input.js';
+import { SlugifyOptions } from './slugify.js';
+/**
+ * SlugField — a read-only mirror of another field, slugified.
+ *
+ * Read-only rather than editable-with-sync: a slug that the user can edit and that also
+ * follows the title has to decide which wins on every keystroke, and every answer to that
+ * surprises someone. This one always follows. A screen that needs a hand-written slug
+ * should use a plain Input.
+ */
+import * as React from "react";
+export interface SlugFieldProps extends Omit<InputProps, "value" | "defaultValue" | "onChange" | "readOnly" | "type" | "prefix">, SlugifyOptions {
+    /** The source value. Controlled — the slug is derived, never held. */
+    value: string | number | null | undefined;
+    /** Replaces the built-in derivation entirely. */
+    transform?: (value: string | number | null | undefined) => string;
+    /** Rendered before the slug, inside the field — a domain or a path prefix. */
+    prefix?: React.ReactNode;
+}
+export declare const SlugField: React.ForwardRefExoticComponent<Omit<SlugFieldProps, "ref"> & React.RefAttributes<HTMLInputElement>>;

package/dist/components/base/text-inputs/slugify.d.cts

@@ -0,0 +1,12 @@
+export interface SlugifyOptions {
+    /** Character joining words. */
+    separator?: string;
+    lowercase?: boolean;
+    /** Strips leading and trailing separators. */
+    trim?: boolean;
+}
+/**
+ * Unicode-aware: `\p{Letter}` keeps non-Latin scripts intact instead of stripping them to
+ * an empty string, and the NFKD pass folds accents onto their base letters first.
+ */
+export declare function slugify(value: string | number | null | undefined, { separator, lowercase, trim }?: SlugifyOptions): string;

package/dist/components/base/text-inputs/slugify.d.ts

@@ -0,0 +1,12 @@
+export interface SlugifyOptions {
+    /** Character joining words. */
+    separator?: string;
+    lowercase?: boolean;
+    /** Strips leading and trailing separators. */
+    trim?: boolean;
+}
+/**
+ * Unicode-aware: `\p{Letter}` keeps non-Latin scripts intact instead of stripping them to
+ * an empty string, and the NFKD pass folds accents onto their base letters first.
+ */
+export declare function slugify(value: string | number | null | undefined, { separator, lowercase, trim }?: SlugifyOptions): string;

package/dist/components/base/text-inputs/textarea.d.cts

@@ -0,0 +1,26 @@
+import { StringsProp } from '../../../lib/strings.cjs';
+import { InputStrings } from './input.strings.cjs';
+import * as React from "react";
+export interface TextareaProps extends Omit<React.ComponentProps<"textarea">, "onChange"> {
+    /** Overrides the character-count and clear copy. */
+    strings?: StringsProp<InputStrings>;
+    /** Character cap, also the denominator of the count. */
+    maxLength?: number;
+    /** Shows the current and maximum character count. */
+    showCharacterCount?: boolean;
+    /** Shows an inline clear action once the field has a value. */
+    clearable?: boolean;
+    onClear?: () => void;
+    /** Replaces the trailing affordance with a loading indicator. */
+    loading?: boolean;
+    /** Applies the invalid styling. Validation copy stays with FormField. */
+    invalid?: boolean;
+    /** Smallest height, in rows. */
+    minRows?: number;
+    /** Height at which the field stops growing and starts scrolling. */
+    maxRows?: number;
+    onChange?: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    value?: string;
+    defaultValue?: string;
+}
+export declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;

package/dist/components/base/text-inputs/textarea.d.ts

@@ -0,0 +1,26 @@
+import { StringsProp } from '../../../lib/strings.js';
+import { InputStrings } from './input.strings.js';
+import * as React from "react";
+export interface TextareaProps extends Omit<React.ComponentProps<"textarea">, "onChange"> {
+    /** Overrides the character-count and clear copy. */
+    strings?: StringsProp<InputStrings>;
+    /** Character cap, also the denominator of the count. */
+    maxLength?: number;
+    /** Shows the current and maximum character count. */
+    showCharacterCount?: boolean;
+    /** Shows an inline clear action once the field has a value. */
+    clearable?: boolean;
+    onClear?: () => void;
+    /** Replaces the trailing affordance with a loading indicator. */
+    loading?: boolean;
+    /** Applies the invalid styling. Validation copy stays with FormField. */
+    invalid?: boolean;
+    /** Smallest height, in rows. */
+    minRows?: number;
+    /** Height at which the field stops growing and starts scrolling. */
+    maxRows?: number;
+    onChange?: (event: React.ChangeEvent<HTMLTextAreaElement>) => void;
+    value?: string;
+    defaultValue?: string;
+}
+export declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;

package/dist/components/base/text-inputs/use-field-value.d.cts

@@ -0,0 +1,33 @@
+export interface UseFieldValueOptions {
+    /** Controlled value. Its presence is what makes the field controlled. */
+    controlledValue?: string;
+    defaultValue?: string;
+    maxLength?: number;
+    showCharacterCount?: boolean;
+    /** A caller-supplied id wins; otherwise one is generated. */
+    providedId?: string;
+    idPrefix?: string;
+}
+export interface UseFieldValueResult {
+    id: string;
+    value: string;
+    isControlled: boolean;
+    characterCount: number;
+    hasCharacterLimit: boolean;
+    /** True when a count should be rendered — a limit is set and the caller asked. */
+    showCount: boolean;
+    hasValue: boolean;
+    /** Writes the internal value when uncontrolled. Returns false if the limit blocked it. */
+    updateValue: (next: string) => boolean;
+    clearValue: () => void;
+    wouldExceedLimit: (next: string) => boolean;
+}
+/**
+ * The value bookkeeping every text control repeats: controlled-versus-not, a generated
+ * id, the character count, and the limit.
+ *
+ * A hook rather than four copies, because getting the controlled/uncontrolled branch
+ * subtly different between Input, Textarea, and SearchInput is precisely how two fields
+ * in one form end up behaving differently under a form library.
+ */
+export declare function useFieldValue({ controlledValue, defaultValue, maxLength, showCharacterCount, providedId, idPrefix, }: UseFieldValueOptions): UseFieldValueResult;

package/dist/components/base/text-inputs/use-field-value.d.ts

@@ -0,0 +1,33 @@
+export interface UseFieldValueOptions {
+    /** Controlled value. Its presence is what makes the field controlled. */
+    controlledValue?: string;
+    defaultValue?: string;
+    maxLength?: number;
+    showCharacterCount?: boolean;
+    /** A caller-supplied id wins; otherwise one is generated. */
+    providedId?: string;
+    idPrefix?: string;
+}
+export interface UseFieldValueResult {
+    id: string;
+    value: string;
+    isControlled: boolean;
+    characterCount: number;
+    hasCharacterLimit: boolean;
+    /** True when a count should be rendered — a limit is set and the caller asked. */
+    showCount: boolean;
+    hasValue: boolean;
+    /** Writes the internal value when uncontrolled. Returns false if the limit blocked it. */
+    updateValue: (next: string) => boolean;
+    clearValue: () => void;
+    wouldExceedLimit: (next: string) => boolean;
+}
+/**
+ * The value bookkeeping every text control repeats: controlled-versus-not, a generated
+ * id, the character count, and the limit.
+ *
+ * A hook rather than four copies, because getting the controlled/uncontrolled branch
+ * subtly different between Input, Textarea, and SearchInput is precisely how two fields
+ * in one form end up behaving differently under a form library.
+ */
+export declare function useFieldValue({ controlledValue, defaultValue, maxLength, showCharacterCount, providedId, idPrefix, }: UseFieldValueOptions): UseFieldValueResult;

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

@@ -0,0 +1 @@
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineStatus, } from './timeline.cjs';

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

@@ -0,0 +1 @@
+export { Timeline, type TimelineProps, type TimelineItem, type TimelineStatus, } from './timeline.js';