@motech-development/breeze-ui 2.3.1 → 3.0.0

package/dist/primitives/Table/Table.d.ts

@@ -0,0 +1,226 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { BreezeCollectionItem, CollectionContentProps, CollectionKey, CollectionSelection, CollectionVirtualization } from '../../internal/types/collection';
+/** Consumer-owned table sort descriptor. */
+export interface TableSort {
+    /** Stable key of the sorted column. */
+    column: CollectionKey;
+    /** Current sort direction. */
+    direction: 'ascending' | 'descending';
+}
+/** Supported structural table presentation modes. */
+export type TableLayout = 'responsive' | 'responsiveGrid' | 'grid';
+/** Optional visual treatment for the table's lower edge. */
+export type TableBoundary = 'none' | 'strong';
+/** Canonical column widths for content, full controls, and icon actions. */
+export type TableColumnWidth = 'auto' | 'control' | 'icon';
+/** Domain-neutral emphasis applied to one data row. */
+export type TableRowTone = 'default' | 'muted';
+/** Structural presentation for records and grouped section rows. */
+export type TableRowPresentation = 'data' | 'section';
+type TableRootNativeProps = Omit<HTMLAttributes<HTMLTableElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface TableRootSharedProps extends TableRootNativeProps {
+    /** Optional visual treatment for the table's lower edge. Defaults to `none`. */
+    boundary?: TableBoundary;
+    /** Ordered header, body, and optional footer sections. */
+    children: ReactNode;
+    /** Keys whose rows cannot receive focus, selection, or actions. */
+    disabledKeys?: Iterable<CollectionKey>;
+    /** Responsive native table, responsive desktop grid, or persistent CSS grid rows. Defaults to `responsive`. */
+    layout?: TableLayout;
+    /** Enables multiple row selection. Defaults to `false`. */
+    multiple?: boolean;
+    /** Ref to the rendered table or virtualized grid element. */
+    ref?: Ref<HTMLElement>;
+    /** Optional fixed- or variable-height row windowing configuration. */
+    virtualization?: CollectionVirtualization;
+}
+interface ControlledTableSelectionProps {
+    /** Current selected row keys. */
+    selection: CollectionSelection;
+    /** Called with the next selected row keys. */
+    onSelectionChange: (selection: CollectionSelection) => void;
+    /** Excluded when selection is controlled. */
+    defaultSelection?: never;
+    /** Controlled mutable state cannot be marked read-only. */
+    readOnly?: false;
+}
+interface ReadOnlyTableSelectionProps {
+    /** Current immutable selected row keys. */
+    selection: CollectionSelection;
+    /** Marks controlled row selection and sorting as intentionally immutable. */
+    readOnly: true;
+    /** Excluded when selection is controlled. */
+    defaultSelection?: never;
+    /** Excluded because read-only selection cannot change. */
+    onSelectionChange?: never;
+}
+interface UncontrolledTableSelectionProps {
+    /** Initial selected row keys. Defaults to an empty selection. */
+    defaultSelection?: CollectionSelection;
+    /** Called with the next selected row keys. */
+    onSelectionChange?: (selection: CollectionSelection) => void;
+    /** Uncontrolled state cannot be marked read-only. */
+    readOnly?: false;
+    /** Excluded when selection is uncontrolled. */
+    selection?: never;
+}
+interface ControlledTableSortProps {
+    /** Current consumer-owned sort descriptor. */
+    sort: TableSort;
+    /** Called when a sortable heading requests a new descriptor. */
+    onSortChange: (sort: TableSort) => void;
+    /** Excluded when sorting is controlled. */
+    defaultSort?: never;
+}
+interface UncontrolledTableSortProps {
+    /** Initial sort descriptor. */
+    defaultSort?: TableSort;
+    /** Called when the internally retained descriptor changes. */
+    onSortChange?: (sort: TableSort) => void;
+    /** Excluded when sorting is uncontrolled. */
+    sort?: never;
+}
+/** Props for a controlled, read-only, or uncontrolled interactive table. */
+export type TableRootProps = TableRootSharedProps & (ControlledTableSelectionProps | ReadOnlyTableSelectionProps | UncontrolledTableSelectionProps) & (ControlledTableSortProps | UncontrolledTableSortProps);
+/** Props for static or generic table columns. */
+export type TableHeaderProps<Column extends BreezeCollectionItem = BreezeCollectionItem> = Omit<HTMLAttributes<HTMLTableSectionElement>, 'children' | 'style'> & CollectionContentProps<Column> & {
+    /** Stable key for this measurable ordered header section. */
+    id?: CollectionKey;
+    /** Ref to the rendered table header. */
+    ref?: Ref<HTMLTableSectionElement>;
+};
+/** Props for one accessible table column heading. */
+export interface TableColumnProps extends Omit<HTMLAttributes<HTMLTableCellElement>, 'align' | 'id' | 'style'> {
+    /** Heading alignment. Defaults to `start`. */
+    align?: 'start' | 'center' | 'end';
+    /** Visible accessible column heading. */
+    children: ReactNode;
+    /** Derives a compact record label from this heading. Defaults to `true`. */
+    compactLabel?: boolean;
+    /** Stable string or number column key. */
+    id: CollectionKey;
+    /** Marks this heading as the row label announced during cell navigation. Defaults to `false`. */
+    rowHeader?: boolean;
+    /** Allows this heading to request sort changes. Defaults to `false`. */
+    sortable?: boolean;
+    /** Ref to the rendered column heading. */
+    ref?: Ref<HTMLTableCellElement>;
+    /** Plain-text accessible and compact label used when the visible heading is not a string. */
+    textValue?: string;
+    /** Canonical width for content, full controls, or icon actions. Defaults to `auto`. */
+    width?: TableColumnWidth;
+}
+/** Props for a static or generic ordered table body section. */
+export type TableBodyProps<Item extends BreezeCollectionItem = BreezeCollectionItem> = Omit<HTMLAttributes<HTMLTableSectionElement>, 'children' | 'style'> & CollectionContentProps<Item> & {
+    /** Content displayed when this body has no rows. */
+    emptyContent?: ReactNode;
+    /** Stable key for this measurable ordered body section. */
+    id?: CollectionKey;
+    /** Ref to the rendered table body. */
+    ref?: Ref<HTMLTableSectionElement>;
+};
+/** Props for a static or generic ordered table footer section. */
+export type TableFooterProps<Item extends BreezeCollectionItem = BreezeCollectionItem> = Omit<HTMLAttributes<HTMLTableSectionElement>, 'children' | 'style'> & CollectionContentProps<Item> & {
+    /** Stable key for this measurable ordered footer section. */
+    id?: CollectionKey;
+    /** Ref to the rendered table footer. */
+    ref?: Ref<HTMLTableSectionElement>;
+};
+/** Props for one keyed table row. */
+export interface TableRowProps extends Omit<HTMLAttributes<HTMLTableRowElement>, 'id' | 'onClick' | 'onClickCapture' | 'style'> {
+    /** Ordered cells matching every visible table heading exactly once and in the same order, including after conditional column changes. */
+    children: ReactNode;
+    /** Prevents focus, selection, and actions for this row. Defaults to `false`. */
+    disabled?: boolean;
+    /** Stable string or number row key. */
+    id: CollectionKey;
+    /** Called with this row key when its action is invoked. */
+    onAction?: (key: CollectionKey) => void;
+    /** Record or grouped section geometry. Defaults to `data`. */
+    presentation?: TableRowPresentation;
+    /** Ref to the rendered row. */
+    ref?: Ref<HTMLTableRowElement>;
+    /** Plain-text row representation used for typeahead and accessibility. */
+    textValue: string;
+    /** Domain-neutral visual emphasis. Defaults to `default`. */
+    tone?: TableRowTone;
+}
+/** Props for one table data cell. */
+export interface TableCellProps extends Omit<HTMLAttributes<HTMLTableCellElement>, 'align' | 'id' | 'style'> {
+    /** Cell alignment at table widths. Defaults to `start`. */
+    align?: 'start' | 'center' | 'end';
+    /** Visible cell content. */
+    children: ReactNode;
+    /** Stable key of the corresponding column heading. */
+    column: CollectionKey;
+    /** Canonical content geometry. `disclosure` positions one bare arrow for an actionable row. Defaults to `data`. */
+    presentation?: 'data' | 'disclosure';
+    /** Ref to the rendered data cell. */
+    ref?: Ref<HTMLTableCellElement>;
+    /** Plain-text cell value used for accessibility when content is not text. */
+    textValue?: string;
+}
+/** Props for the canonical action indicator of an actionable row. */
+export interface TableDisclosureProps extends Omit<TableCellProps, 'children' | 'presentation' | 'textValue'> {
+    /** Position over a standard compact row or remain in an explicit grid track. Defaults to `overlay`. */
+    position?: 'flow' | 'overlay';
+}
+/** Props for a table loading row and load-more sentinel. */
+export interface TableLoadMoreProps extends Omit<HTMLAttributes<HTMLTableRowElement>, 'style'> {
+    /** Visible loading-row content. */
+    children: ReactNode;
+    /** Shows the loading row and suppresses duplicate requests. Defaults to `false`. */
+    loading?: boolean;
+    /** Called once when more consumer-owned rows should be requested. */
+    onLoadMore: () => void | Promise<void>;
+    /** Trigger distance as a proportion of the scroll viewport. Defaults to `1`. */
+    offset?: number;
+    /** Ref to the rendered native or virtualized loading row. */
+    ref?: Ref<HTMLTableRowElement | HTMLDivElement>;
+}
+/** Coordinates semantic table navigation, row state, sorting, and responsive labels. */
+export declare function Root({ boundary, children, className, defaultSelection, defaultSort, disabledKeys, layout, multiple, onSelectionChange, onSortChange, readOnly, ref, selection, sort, virtualization, ...props }: Readonly<TableRootProps>): ReactElement;
+/** Renders one accessible heading that can optionally request sorting. */
+export declare function Column(props: Readonly<TableColumnProps>): ReactElement;
+/** Renders static or generic accessible column headings. */
+export declare function Header<Column extends BreezeCollectionItem>({ children, className, id, items, ref, ...props }: Readonly<TableHeaderProps<Column>>): ReactElement;
+/** Renders a stable ordered table body with static or generic rows. */
+export declare function Body<Item extends BreezeCollectionItem>({ children, className, emptyContent, id, items, ref, ...props }: Readonly<TableBodyProps<Item>>): ReactElement;
+/** Renders a stable ordered table footer with static or generic rows. */
+export declare function Footer<Item extends BreezeCollectionItem>({ children, className, id, items, ref, ...props }: Readonly<TableFooterProps<Item>>): ReactElement;
+/** Renders one keyed row whose cells follow heading order. */
+export declare function Row({ 'aria-describedby': describedBy, className, disabled, id, onAction, presentation, ref, textValue, tone, ...props }: Readonly<TableRowProps>): ReactElement;
+/** Renders one data cell and derives its compact label from the matching heading. */
+export declare function Cell({ align, className, column, presentation, ref, textValue, ...props }: Readonly<TableCellProps>): ReactElement;
+/** Renders the canonical bare arrow for an actionable row. */
+export declare function Disclosure({ position, ...props }: Readonly<TableDisclosureProps>): ReactElement;
+/** Renders a loading row and deduplicated intersection sentinel. */
+export declare function LoadMore({ className, loading, offset, onLoadMore, ref, ...props }: Readonly<TableLoadMoreProps>): ReactElement;
+/**
+ * Coordinates ordered static or generic table sections, responsive record
+ * labels, row interaction, consumer-owned sorting, and optional virtualization.
+ *
+ * @summary responsive compound data table with optional virtualization
+ */
+export declare const Table: {
+    /** Ordered static or generic row section. */
+    Body: typeof Body;
+    /** One cell associated with a stable heading key. */
+    Cell: typeof Cell;
+    /** One sortable or static accessible column heading. */
+    Column: typeof Column;
+    /** Canonical bare action indicator for an actionable row. */
+    Disclosure: typeof Disclosure;
+    /** Ordered static or generic footer section. */
+    Footer: typeof Footer;
+    /** Ordered static or generic heading section. */
+    Header: typeof Header;
+    /** Loading row and deduplicated load-more sentinel. */
+    LoadMore: typeof LoadMore;
+    /** Interactive semantic table root. */
+    Root: typeof Root;
+    /** One keyed selectable or actionable row. */
+    Row: typeof Row;
+};
+export {};
+//# sourceMappingURL=Table.d.ts.map

package/dist/primitives/Table/Table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Table.d.ts","sourceRoot":"","sources":["../../../src/primitives/Table/Table.tsx"],"names":[],"mappings":"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"}

package/dist/primitives/Tabs/Tabs.d.ts

@@ -0,0 +1,105 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { CollectionKey } from '../../internal/types/collection';
+type TabsRootNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface TabsRootSharedProps extends TabsRootNativeProps {
+    /** Tab list and panels. */
+    children: ReactNode;
+    /** Disables every tab. Defaults to `false`. */
+    disabled?: boolean;
+    /** Arrow-key and layout direction. Defaults to `horizontal`. */
+    orientation?: 'horizontal' | 'vertical';
+    /** Ref to the rendered tabs root. */
+    ref?: Ref<HTMLDivElement>;
+}
+interface ControlledTabsRootProps {
+    /** Current selected tab key. */
+    value: CollectionKey;
+    /** Called with the next selected tab key. */
+    onChange: (value: CollectionKey) => void;
+    defaultValue?: never;
+    readOnly?: false;
+}
+interface ReadOnlyTabsRootProps {
+    /** Current immutable selected tab key. */
+    value: CollectionKey;
+    /** Marks controlled selection as intentionally immutable. */
+    readOnly: true;
+    defaultValue?: never;
+    onChange?: never;
+}
+interface UncontrolledTabsRootProps {
+    /** Initial selected tab key. */
+    defaultValue?: CollectionKey;
+    /** Called with the next selected tab key. */
+    onChange?: (value: CollectionKey) => void;
+    readOnly?: false;
+    value?: never;
+}
+/** Props for controlled, read-only, or uncontrolled tab selection. */
+export type TabsRootProps = TabsRootSharedProps & (ControlledTabsRootProps | ReadOnlyTabsRootProps | UncontrolledTabsRootProps);
+/** Props for the accessible list of tab labels. */
+export interface TabsListProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+    /** Tab label parts. */
+    children: ReactNode;
+    /** Ref to the rendered tab list. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Props for one selectable tab label. */
+export interface TabsTabProps extends Omit<HTMLAttributes<HTMLDivElement>, 'id' | 'onClick' | 'onClickCapture' | 'style'> {
+    /** Visible tab label. */
+    children: ReactNode;
+    /** Prevents focus and selection. Defaults to `false`. */
+    disabled?: boolean;
+    /** Stable string or number key matching its panel. */
+    id: CollectionKey;
+    /** Ref to the rendered tab. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Props for the optional grouping of tab panels. */
+export interface TabsPanelsProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
+    /** Tab panels. */
+    children: ReactNode;
+    /** Ref to the rendered panel group. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Props for content associated with one tab. */
+export interface TabsPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, 'id' | 'style'> {
+    /** Panel content. */
+    children: ReactNode;
+    /** Stable key matching its tab. */
+    id: CollectionKey;
+    /** Keeps inactive content mounted and inert. Defaults to `false`. */
+    forceMount?: boolean;
+    /** Ref to the rendered panel. */
+    ref?: Ref<HTMLDivElement>;
+}
+/** Coordinates tab selection, keyboard navigation, and panel visibility. */
+export declare function Root({ className, defaultValue, disabled, onChange, orientation, readOnly: _readOnly, ref, value, ...props }: Readonly<TabsRootProps>): ReactElement;
+/** Groups tab labels and inherits root orientation. */
+export declare function List({ className, ref, ...props }: Readonly<TabsListProps>): ReactElement;
+/** Renders one keyed tab label. */
+export declare function Tab({ className, disabled, id, ref, ...props }: Readonly<TabsTabProps>): ReactElement;
+/** Groups keyed panels for transition coordination. */
+export declare function Panels({ className, ref, ...props }: Readonly<TabsPanelsProps>): ReactElement;
+/** Renders content associated with a keyed tab. */
+export declare function Panel({ className, forceMount, id, ref, ...props }: Readonly<TabsPanelProps>): ReactElement;
+/**
+ * Coordinates keyed tab labels, orientation-aware keyboard navigation, and
+ * visibility of their associated panels.
+ *
+ * @summary accessible compound tabbed content navigation
+ */
+export declare const Tabs: {
+    /** List of selectable tab labels. */
+    List: typeof List;
+    /** Content associated with one tab. */
+    Panel: typeof Panel;
+    /** Optional panel collection wrapper. */
+    Panels: typeof Panels;
+    /** Selection and orientation root. */
+    Root: typeof Root;
+    /** One keyed selectable label. */
+    Tab: typeof Tab;
+};
+export {};
+//# sourceMappingURL=Tabs.d.ts.map

package/dist/primitives/Tabs/Tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tabs.d.ts","sourceRoot":"","sources":["../../../src/primitives/Tabs/Tabs.tsx"],"names":[],"mappings":"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"}

package/dist/primitives/Tag/Tag.d.ts

@@ -0,0 +1,18 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { CollectionKey } from '../../internal/types/collection';
+/** Props for one keyed tag. */ export interface TagProps extends Omit<HTMLAttributes<HTMLDivElement>, 'id' | 'onClick' | 'style'> {
+    /** Visible tag content. */ children: ReactNode;
+    /** Prevents focus, selection, actions, and removal. Defaults to `false`. */ disabled?: boolean;
+    /** Stable tag key. */ id: CollectionKey;
+    /** Called with this tag key when its semantic action is invoked. */ onAction?: (key: CollectionKey) => void;
+    /** Ref to the rendered tag. */ ref?: Ref<HTMLDivElement>;
+    /** Plain text for accessibility/typeahead. */ textValue: string;
+}
+/**
+ * Renders one keyed, focusable tag for selection, semantic actions, or removal
+ * by its containing TagGroup.
+ *
+ * @summary keyed interactive item for a tag collection
+ */
+export declare function Tag({ className, disabled, id, onAction, ref, ...props }: Readonly<TagProps>): ReactElement;
+//# sourceMappingURL=Tag.d.ts.map

package/dist/primitives/Tag/Tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.d.ts","sourceRoot":"","sources":["../../../src/primitives/Tag/Tag.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAKrE,+BAA+B,CAAC,MAAM,WAAW,QAC/C,SAAQ,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACxE,2BAA2B,CAAC,QAAQ,EAAE,SAAS,CAAC;IAChD,4EAA4E,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAChG,sBAAsB,CAAC,EAAE,EAAE,aAAa,CAAC;IACzC,oEAAoE,CAAC,QAAQ,CAAC,EAAE,CAC9E,GAAG,EAAE,aAAa,KACf,IAAI,CAAC;IACV,+BAA+B,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1D,8CAA8C,CAAC,SAAS,EAAE,MAAM,CAAC;CAClE;AACD;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,EAClB,SAAS,EACT,QAAgB,EAChB,EAAE,EACF,QAAQ,EACR,GAAG,EACH,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,YAAY,CAWnC"}

package/dist/primitives/TagGroup/TagGroup.d.ts

@@ -0,0 +1,60 @@
+import type { HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { BreezeCollectionItem, CollectionContentProps, CollectionKey, CollectionSelection } from '../../internal/types/collection';
+import { type TextFieldDescriptionProps, type TextFieldLabelProps } from '../TextField/TextField';
+interface Shared extends Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'onChange' | 'style'> {
+    /** Compound label, tag list, and supporting guidance parts. */ children: ReactNode;
+    /** Keys whose tags cannot receive focus, selection, actions, or removal. */ disabledKeys?: Iterable<CollectionKey>;
+    /** Called with the stable keys removed through keyboard interaction. */ onRemove?: (keys: CollectionKey[]) => void;
+    /** Ref to the rendered tag-group root. */ ref?: Ref<HTMLDivElement>;
+}
+type State = {
+    /** Current selected tag keys, or every key for select-all state. */
+    selection: CollectionSelection;
+    /** Called with the next selected tag keys. */
+    onSelectionChange: (selection: CollectionSelection) => void;
+    /** Excluded when selection is controlled. */
+    defaultSelection?: never;
+    /** Controlled mutable state cannot be marked read-only. */
+    readOnly?: false;
+} | {
+    /** Current immutable selected tag keys. */
+    selection: CollectionSelection;
+    /** Prevents selection changes and removal. */
+    readOnly: true;
+    /** Excluded because read-only selection cannot change. */
+    onSelectionChange?: never;
+    /** Excluded when selection is controlled. */
+    defaultSelection?: never;
+} | {
+    /** Initial selected tag keys. */
+    defaultSelection?: CollectionSelection;
+    /** Called with the next selected tag keys. */
+    onSelectionChange?: (selection: CollectionSelection) => void;
+    /** Excluded when selection is uncontrolled. */
+    selection?: never;
+    /** Uncontrolled state cannot be marked read-only. */
+    readOnly?: false;
+};
+/** Tag-group selection and removal props. */ export type TagGroupRootProps = Shared & State;
+/** Props for the visible tag-group label. */ export type TagGroupLabelProps = TextFieldLabelProps;
+/** Props for supporting tag-group guidance. */ export type TagGroupDescriptionProps = TextFieldDescriptionProps;
+/** Static or generic tag list props. */ export type TagGroupListProps<Item extends BreezeCollectionItem = BreezeCollectionItem> = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'style'> & CollectionContentProps<Item> & {
+    /** Content displayed when the tag collection has no items. */ emptyContent?: ReactNode;
+    /** Ref to the rendered tag-list element. */ ref?: Ref<HTMLDivElement>;
+};
+/** Coordinates tag selection, focus, and removal. */ export declare function Root({ children, className, defaultSelection, disabledKeys, onRemove, onSelectionChange, readOnly, ref, selection, ...props }: Readonly<TagGroupRootProps>): ReactElement;
+/** Renders static or typed generic tags. */ export declare function List<Item extends BreezeCollectionItem>({ children, className, emptyContent, items, ref, ...props }: Readonly<TagGroupListProps<Item>>): ReactElement;
+/**
+ * Coordinates a labelled static or generic tag collection with optional
+ * multiple selection, disabled keys, and application-owned removal.
+ *
+ * @summary accessible selectable and removable tag collection
+ */
+export declare const TagGroup: {
+    /** Supporting guidance associated with the tag group. */ Description: typeof import("../TextField/TextField").Description;
+    /** Visible label associated with the tag list. */ Label: typeof import("../TextField/TextField").Label;
+    /** Static or typed generic tag collection. */ List: typeof List;
+    /** Selection, focus, and removal coordination root. */ Root: typeof Root;
+};
+export {};
+//# sourceMappingURL=TagGroup.d.ts.map

package/dist/primitives/TagGroup/TagGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TagGroup.d.ts","sourceRoot":"","sources":["../../../src/primitives/TagGroup/TagGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AASf,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACzB,MAAM,wBAAwB,CAAC;AAIhC,UAAU,MACR,SAAQ,IAAI,CACV,cAAc,CAAC,cAAc,CAAC,EAC9B,UAAU,GAAG,UAAU,GAAG,OAAO,CAClC;IACD,+DAA+D,CAAC,QAAQ,EAAE,SAAS,CAAC;IACpF,4EAA4E,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IACpH,wEAAwE,CAAC,QAAQ,CAAC,EAAE,CAClF,IAAI,EAAE,aAAa,EAAE,KAClB,IAAI,CAAC;IACV,0CAA0C,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CACtE;AACD,KAAK,KAAK,GACN;IACE,oEAAoE;IACpE,SAAS,EAAE,mBAAmB,CAAC;IAC/B,8CAA8C;IAC9C,iBAAiB,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC5D,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,GACD;IACE,2CAA2C;IAC3C,SAAS,EAAE,mBAAmB,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,EAAE,IAAI,CAAC;IACf,0DAA0D;IAC1D,iBAAiB,CAAC,EAAE,KAAK,CAAC;IAC1B,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,KAAK,CAAC;CAC1B,GACD;IACE,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC7D,+CAA+C;IAC/C,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AACN,6CAA6C,CAAC,MAAM,MAAM,iBAAiB,GACzE,MAAM,GAAG,KAAK,CAAC;AACjB,6CAA6C,CAAC,MAAM,MAAM,kBAAkB,GAC1E,mBAAmB,CAAC;AACtB,+CAA+C,CAAC,MAAM,MAAM,wBAAwB,GAClF,yBAAyB,CAAC;AAC5B,wCAAwC,CAAC,MAAM,MAAM,iBAAiB,CACpE,IAAI,SAAS,oBAAoB,GAAG,oBAAoB,IACtD,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,GAC5D,sBAAsB,CAAC,IAAI,CAAC,GAAG;IAC7B,8DAA8D,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IACxF,4CAA4C,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CACxE,CAAC;AAGJ,qDAAqD,CAAC,wBAAgB,IAAI,CAAC,EACzE,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,iBAAiB,EACjB,QAAgB,EAChB,GAAG,EACH,SAAS,EACT,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,YAAY,CA0B5C;AACD,4CAA4C,CAAC,wBAAgB,IAAI,CAC/D,IAAI,SAAS,oBAAoB,EACjC,EACA,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,KAAK,EACL,GAAG,EACH,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,GAAG,YAAY,CAYlD;AACD;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;IACnB,yDAAyD;IAEzD,kDAAkD;IAClD,8CAA8C;IAC9C,uDAAuD;CACxD,CAAC"}

package/dist/primitives/TextArea/TextArea.d.ts

@@ -0,0 +1,40 @@
+import type { ReactElement, Ref, TextareaHTMLAttributes } from 'react';
+import type { ControlSize } from '../../internal/styling/visual';
+import { type TextFieldDescriptionProps, type TextFieldErrorProps, type TextFieldLabelProps, type TextFieldRootProps } from '../TextField/TextField';
+/** Props for controlled, read-only, or uncontrolled multiline field state. */
+export type TextAreaRootProps = TextFieldRootProps;
+/** Props for the visible multiline field label. */
+export type TextAreaLabelProps = TextFieldLabelProps;
+/** Props for supporting text associated with the multiline control. */
+export type TextAreaDescriptionProps = TextFieldDescriptionProps;
+/** Props for an accessible multiline validation message. */
+export type TextAreaErrorProps = TextFieldErrorProps;
+/** Props for the native multiline control part. */
+export interface TextAreaControlProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'children' | 'className' | 'defaultValue' | 'disabled' | 'onChange' | 'readOnly' | 'required' | 'style' | 'value'> {
+    /** Placement and composition classes. */
+    className?: string;
+    /** Ref to the rendered textarea. */
+    ref?: Ref<HTMLTextAreaElement>;
+    /** Canonical control size. Defaults to `md`. */
+    size?: ControlSize;
+}
+/** Renders the editable native multiline control for a TextArea. */
+export declare function Control({ className, ref, size, ...props }: Readonly<TextAreaControlProps>): ReactElement;
+/**
+ * Accessible compound multiline text-entry primitive.
+ *
+ * @summary labelled multiline text entry with validation anatomy
+ */
+export declare const TextArea: {
+    /** Editable native multiline control. */
+    Control: typeof Control;
+    /** Supporting guidance associated with the control. */
+    Description: typeof import("../TextField/TextField").Description;
+    /** Validation message associated with an invalid control. */
+    Error: typeof import("../TextField/TextField").Error;
+    /** Persistent accessible label. */
+    Label: typeof import("../TextField/TextField").Label;
+    /** State and accessibility root. */
+    Root: typeof import("../TextField/TextField").Root;
+};
+//# sourceMappingURL=TextArea.d.ts.map

package/dist/primitives/TextArea/TextArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextArea.d.ts","sourceRoot":"","sources":["../../../src/primitives/TextArea/TextArea.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAKvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAgBhC,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,uEAAuE;AACvE,MAAM,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAEjE,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAC;AAErD,mDAAmD;AACnD,MAAM,WAAW,oBACf,SAAQ,IAAI,CACV,sBAAsB,CAAC,mBAAmB,CAAC,EACzC,UAAU,GACV,WAAW,GACX,cAAc,GACd,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,OAAO,GACP,OAAO,CACV;IACD,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,GAAG,CAAC,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC/B,gDAAgD;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,EACtB,SAAS,EACT,GAAG,EACH,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GAAG,YAAY,CAQ/C;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACnB,yCAAyC;;IAEzC,uDAAuD;;IAEvD,6DAA6D;;IAE7D,mCAAmC;;IAEnC,oCAAoC;;CAErC,CAAC"}

package/dist/primitives/TextField/TextField.d.ts

@@ -0,0 +1,102 @@
+import type { HTMLAttributes, InputHTMLAttributes, LabelHTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import type { ControlSize } from '../../internal/styling/visual';
+type TextFieldRootNativeProps = Omit<HTMLAttributes<HTMLDivElement>, 'children' | 'defaultValue' | 'onChange' | 'style'>;
+interface TextFieldRootSharedProps extends TextFieldRootNativeProps {
+    /** Compound label, input, description, and error parts. */
+    children: ReactNode;
+    /** Prevents editing and focus. Defaults to `false`. */
+    disabled?: boolean;
+    /** Exposes invalid state to assistive technology and error styling. Defaults to `false`. */
+    invalid?: boolean;
+    /** Marks the field as required for native validation and assistive technology. Defaults to `false`. */
+    required?: boolean;
+    /** Ref to the rendered field container. */
+    ref?: Ref<HTMLDivElement>;
+}
+interface ControlledTextFieldRootProps {
+    /** Current text value. */
+    value: string;
+    /** Called with the next text value. */
+    onChange: (value: string) => void;
+    defaultValue?: never;
+    readOnly?: false;
+}
+interface ReadOnlyTextFieldRootProps {
+    /** Current immutable text value. */
+    value: string;
+    /** Marks a controlled value as intentionally immutable. */
+    readOnly: true;
+    defaultValue?: never;
+    onChange?: never;
+}
+interface UncontrolledTextFieldRootProps {
+    /** Initial text value. Defaults to an empty string. */
+    defaultValue?: string;
+    /** Called with the next text value. */
+    onChange?: (value: string) => void;
+    readOnly?: false;
+    value?: never;
+}
+/** Props for controlled, read-only, or uncontrolled text field state. */
+export type TextFieldRootProps = TextFieldRootSharedProps & (ControlledTextFieldRootProps | ReadOnlyTextFieldRootProps | UncontrolledTextFieldRootProps);
+/** Props for the visible text field label. */
+export interface TextFieldLabelProps extends Omit<LabelHTMLAttributes<HTMLLabelElement>, 'style'> {
+    /** Label content that persistently names the input. */
+    children: ReactNode;
+    /** Ref to the rendered label. */
+    ref?: Ref<HTMLLabelElement>;
+}
+/** Props for the native text input part. */
+export interface TextFieldInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'children' | 'className' | 'defaultValue' | 'disabled' | 'onChange' | 'readOnly' | 'required' | 'size' | 'style' | 'type' | 'value'> {
+    /** Placement and composition classes. */
+    className?: string;
+    /** Ref to the rendered input. */
+    ref?: Ref<HTMLInputElement>;
+    /** Canonical control size. Defaults to `md`. */
+    size?: ControlSize;
+    /** Native text-entry purpose. Defaults to `text`. */
+    type?: 'email' | 'password' | 'tel' | 'text' | 'url';
+}
+/** Props for supporting text associated with the input. */
+export interface TextFieldDescriptionProps extends Omit<HTMLAttributes<HTMLElement>, 'style'> {
+    /** Supporting guidance for the input. */
+    children: ReactNode;
+    /** Ref to the rendered description. */
+    ref?: Ref<HTMLElement>;
+}
+/** Props for an accessible validation message. */
+export interface TextFieldErrorProps extends Omit<HTMLAttributes<HTMLElement>, 'style'> {
+    /** Validation message shown while the root is invalid. */
+    children: ReactNode;
+    /** Ref to the rendered error message. */
+    ref?: Ref<HTMLElement>;
+}
+/** Coordinates accessible text field state and compound anatomy. */
+export declare function Root({ children, className, defaultValue, disabled, invalid, onChange, readOnly, ref, required, value, ...props }: Readonly<TextFieldRootProps>): ReactElement;
+/** Renders the persistent accessible label for a TextField. */
+export declare function Label({ className, ref, ...props }: Readonly<TextFieldLabelProps>): ReactElement;
+/** Renders the editable native input for a TextField. */
+export declare function Input({ className, ref, size, type, ...props }: Readonly<TextFieldInputProps>): ReactElement;
+/** Renders supporting guidance and associates it with a TextField input. */
+export declare function Description({ className, ref, ...props }: Readonly<TextFieldDescriptionProps>): ReactElement;
+/** Renders an associated validation message while a TextField is invalid. */
+declare function ErrorMessage({ className, ref, ...props }: Readonly<TextFieldErrorProps>): ReactElement;
+export { ErrorMessage as Error };
+/**
+ * Accessible compound single-line text-entry primitive.
+ *
+ * @summary labelled single-line text entry with validation anatomy
+ */
+export declare const TextField: {
+    /** Supporting guidance associated with the input. */
+    Description: typeof Description;
+    /** Validation message associated with an invalid input. */
+    Error: typeof ErrorMessage;
+    /** Editable native input. */
+    Input: typeof Input;
+    /** Persistent accessible label. */
+    Label: typeof Label;
+    /** State and accessibility root. */
+    Root: typeof Root;
+};
+//# sourceMappingURL=TextField.d.ts.map

package/dist/primitives/TextField/TextField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextField.d.ts","sourceRoot":"","sources":["../../../src/primitives/TextField/TextField.tsx"],"names":[],"mappings":"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"}