@llmnative/react 1.18.0 → 1.19.0

package/dist/types/src/Theme.d.ts

@@ -337,6 +337,13 @@ export interface ThemeConfig {
         wrapperClassName?: string;
         className?: string;
     };
+    DescriptionList?: {
+        wrapperClassName?: string;
+        className?: string;
+        itemClassName?: string;
+        labelClassName?: string;
+        valueClassName?: string;
+    };
     Tab?: {
         wrapperClassName?: string;
         className?: string;

package/dist/types/src/components/index.d.ts

@@ -15,6 +15,8 @@ export type { ProviderSwitcherProps, ProviderSwitcherItem } from './blocks/Provi
 export { default as Alert } from './ui/Alert';
 export type { AlertProps } from './ui/Alert';
 export { default as Badge } from './ui/Badge';
+export { default as DescriptionList } from './ui/DescriptionList';
+export type { DescriptionListItem, DescriptionListLayout, DescriptionListColumns, DescriptionListProps } from './ui/DescriptionList';
 export * from './ui/Badge';
 export * from './ui/Buttons';
 export { default as Card } from './ui/Card';

package/dist/types/src/components/ui/DescriptionList.d.ts

@@ -0,0 +1,38 @@
+import React from "react";
+/** One label → value pair of a `<DescriptionList>`. */
+export interface DescriptionListItem {
+    /** Stable React key; defaults to the label when it is a string, otherwise the index. */
+    key?: string;
+    label: React.ReactNode;
+    /** `null`, `undefined` and `''` render as the list's `emptyValue`. */
+    value?: React.ReactNode;
+    /** Tooltip for the value; defaults to the value itself when it is a string and `truncate` is on. */
+    title?: string;
+}
+export type DescriptionListLayout = "horizontal" | "stacked";
+export type DescriptionListColumns = 1 | 2 | 3 | 4 | 5 | 6;
+export interface DescriptionListProps {
+    items: readonly DescriptionListItem[];
+    /** `"horizontal"` (default): label column on the left, stacked on small screens.
+     *  `"stacked"`: label above its value, laid out in `columns`. */
+    layout?: DescriptionListLayout;
+    /** Stacked layout only: number of columns from the `lg` breakpoint (1–6, default 1). */
+    columns?: DescriptionListColumns;
+    /** Horizontal layout only: width of the label column (any CSS length, default `"12rem"`). */
+    labelWidth?: string;
+    /** Shown for empty values (default `"—"`). */
+    emptyValue?: React.ReactNode;
+    /** Keep each value on one line with an ellipsis. */
+    truncate?: boolean;
+    wrapperClassName?: string;
+    className?: string;
+    itemClassName?: string;
+    labelClassName?: string;
+    valueClassName?: string;
+}
+/**
+ * Read-only label → value pairs (profile data, a record's facts, summaries), rendered as a
+ * semantic `<dl>`. Use it instead of hand-written `<dl>`/`<dt>`/`<dd>` markup; for editable data use
+ * `<Form>` fields, for many records use `<Table>` or `<Grid>`.
+ */
+export default function DescriptionList({ items, layout, columns, labelWidth, emptyValue, truncate, wrapperClassName, className, itemClassName, labelClassName, valueClassName, }: DescriptionListProps): React.JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnative/react",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "LLM-native React framework for deterministic UI generation. Data-driven by default, schema-driven optional. Ultra-low token consumption — built for AI agents, not just humans.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",