@customafk/lunas-ui 0.2.82 → 0.2.83

package/dist/index-Cp4Db57w.d.cts

@@ -0,0 +1,598 @@
+import { t as TUIGridBreakpoint } from "./ui-grid-D1-Ponqs.cjs";
+import { n as BadgeProps } from "./badge-C_NPjGXe.cjs";
+import { VariantProps } from "class-variance-authority";
+//#region packages/components/features/descriptions/descriptions.variants.d.ts
+/**
+ * These variants only carry surface/border/padding/typography classes. Flex mechanics
+ * (`flex`, `items-*`, `justify-*`, `gap-*`) are expressed as props on the `Flex` component
+ * that wraps each region instead — don't re-add them here.
+ */
+/** Shared size scale across every Description sub-component, matching `ui/badge.tsx`/`ui/button.tsx`'s `xs–xl` scale. */
+type TDescriptionSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+declare const descriptionVariants: (props?: ({
+  surface?: "card" | "nested" | "grouped" | null | undefined;
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionGroupVariants: (props?: ({
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionHeaderVariants: (props?: ({
+  sticky?: boolean | null | undefined;
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionHeaderTitleVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionHeaderDescriptionVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionSectionVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/**
+ * Bottom rule that disappears on the last *visible* row instead of merely the last DOM row.
+ * `:has(~ …)` reads "has a following sibling row/item that isn't search-hidden" — this subsumes
+ * plain `last:border-b-0` and additionally survives a `DescriptionSearch` filter hiding trailing
+ * rows via `data-search-hidden` (see `search.tsx`). `last:border-b-0` stays as a plain fallback.
+ */
+declare const DESCRIPTION_LAST_ROW_SELECTOR = "last:border-b-0 [&:not(:has(~:is([data-slot=\"description-item\"],[data-slot=\"description-row\"]):not([data-search-hidden])))]:border-b-0";
+declare const descriptionItemVariants: (props?: ({
+  orientation?: "vertical" | "horizontal" | null | undefined;
+  bordered?: boolean | null | undefined;
+  inRow?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionItemLabelVariants: (props?: ({
+  orientation?: "vertical" | "horizontal" | null | undefined;
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare const descriptionItemValueVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+/** Layout-only — surface/border classes for a `DescriptionRow`'s wrapper (the row itself, not its cells). */
+declare const descriptionRowVariants: (props?: ({
+  bordered?: boolean | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type DescriptionVariants = VariantProps<typeof descriptionVariants>;
+type DescriptionHeaderVariants = VariantProps<typeof descriptionHeaderVariants>;
+type DescriptionItemVariants = VariantProps<typeof descriptionItemVariants>;
+//#endregion
+//#region packages/components/features/descriptions/context.d.ts
+/** Number of grid columns (out of 12) a label column can occupy. `12` is deliberately excluded so the value column always keeps at least 1. */
+type TDescriptionLabelSpan = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+/**
+ * Label column width — a plain number fixes it at every container width, or an object varies it
+ * per container-query breakpoint (see {@link TUIGridBreakpoint} for the exact pixel value of each key).
+ */
+type TDescriptionLabelColSpan = TDescriptionLabelSpan | Partial<Record<TUIGridBreakpoint, TDescriptionLabelSpan>>;
+/** Whether the nearest ancestor is a `DescriptionGroup` — read by `Description` to pick its `grouped` surface. */
+declare const DescriptionGroupContext: import("react").Context<boolean>;
+type TDescriptionConfig = {
+  labelColSpan: TDescriptionLabelColSpan | null;
+  size: TDescriptionSize;
+  bordered: boolean;
+};
+declare const DESCRIPTION_CONFIG_DEFAULT: TDescriptionConfig;
+/**
+ * Cascading config a `Description`/`DescriptionGroup`/`DescriptionRow` publishes for every descendant
+ * `DescriptionItem`/`DescriptionHeader`/`DescriptionSection` to read. Each provider MERGES over the
+ * inherited value (only overriding the keys it was explicitly given), so `size`/`bordered` inherit
+ * through nested panels and groups unless a descendant sets its own.
+ */
+declare const DescriptionConfigContext: import("react").Context<TDescriptionConfig>;
+/** Set by `DescriptionRow` so a wrapped `DescriptionItem` knows to skip its own bottom rule — the row wrapper owns it instead. */
+declare const DescriptionRowContext: import("react").Context<boolean>;
+type TDescriptionSearch = {
+  query: string;
+  setQuery: (query: string) => void;
+};
+/** Live search query published by `Description`, set by a `DescriptionSearch` input and read by every `DescriptionItem`/`DescriptionCollapsibleSection` to decide their own visibility. */
+declare const DescriptionSearchContext: import("react").Context<TDescriptionSearch>;
+type TDescriptionSectionScope = {
+  report: (id: string, matched: boolean | null) => void;
+};
+/** Lets a `DescriptionItem` report its own search-match state up to the nearest `DescriptionCollapsibleSection`, which aggregates matches to decide its own visibility. `matched: null` means "this item is unmounting". */
+declare const DescriptionSectionScopeContext: import("react").Context<TDescriptionSectionScope | null>;
+//#endregion
+//#region packages/components/features/descriptions/collapsible-section.d.ts
+type DescriptionCollapsibleSectionProps = React.PropsWithChildren<{
+  /** Section label rendered beside the divider line and chevron. */
+  title: string;
+  /** Uncontrolled initial state. @default true */
+  defaultOpen?: boolean;
+  /** Controlled open state — pair with `onOpenChange`. */
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  /**
+   * Set `false` to render a static section header with no trigger/chevron (children always render)
+   * while still participating in `DescriptionSearch` — a search-aware alternative to the flat
+   * `DescriptionSection` divider.
+   * @default true
+   */
+  collapsible?: boolean;
+  className?: string;
+}>;
+/**
+ * A `DescriptionSection`-style divider whose items collapse/expand, and — unlike the flat
+ * `DescriptionSection` — auto-hides itself when every `DescriptionItem` inside it is filtered out by a
+ * `DescriptionSearch` (and auto-opens while a query matches one of its items, so hits are never buried
+ * inside a collapsed section).
+ *
+ * @example
+ * import { Description, DescriptionCollapsibleSection, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionCollapsibleSection title="Advanced" defaultOpen={false}>
+ *     <DescriptionItem label="Internal ID">usr_01hv3k9x2b</DescriptionItem>
+ *   </DescriptionCollapsibleSection>
+ * </Description>
+ */
+declare const DescriptionCollapsibleSection: React.FC<DescriptionCollapsibleSectionProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/badge.d.ts
+type DescriptionBadgeProps = {
+  label: string | number | null | undefined;
+  color?: BadgeProps['color'];
+  variant?: BadgeProps['variant'];
+  size?: BadgeProps['size'];
+};
+declare const DescriptionBadge: React.FC<DescriptionBadgeProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/boolean.d.ts
+type DescriptionBooleanProps = {
+  value: boolean | null | undefined;
+  trueLabel?: string;
+  falseLabel?: string;
+};
+declare const DescriptionBoolean: React.FC<DescriptionBooleanProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/color.d.ts
+type DescriptionColorProps = {
+  /** Any valid CSS color value (`#rrggbb`, `rgb(...)`, a named color, ...). */
+  value: string | null | undefined;
+  /** Text shown next to the swatch. Defaults to the uppercased raw `value`. */
+  label?: string;
+};
+/** A small color swatch + label — for hex codes, theme tokens, or any other color-valued field. */
+declare const DescriptionColor: React.FC<DescriptionColorProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/copy.d.ts
+type DescriptionCopyProps = {
+  value: string | null | undefined;
+  truncate?: boolean;
+};
+declare const DescriptionCopy: React.FC<DescriptionCopyProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/copy-all.d.ts
+type DescriptionCopyAllProps = {
+  /** Accessible label / tooltip text for the button. @default 'Sao chép toàn bộ' */
+  label?: string;
+  className?: string;
+};
+/**
+ * A small icon button that copies every visible `label: value` pair of the nearest ancestor
+ * `Description`/`DescriptionGroup` as plain text — place it explicitly wherever you want it, typically
+ * inside `DescriptionHeader`'s `extra` slot: `<DescriptionHeader extra={<DescriptionCopyAll />} />`.
+ *
+ * Reads the *rendered DOM* rather than any props, because a value cell can render arbitrary nodes —
+ * the only universally correct "what's currently displayed" is what's actually painted. Section/header
+ * titles are included as heading lines so the pasted text keeps its structure, and anything hidden by a
+ * `DescriptionSearch` filter (or a collapsed `DescriptionCollapsibleSection`) is skipped — copying
+ * matches what's currently visible on screen.
+ *
+ * @example
+ * import { Description, DescriptionHeader } from '@customafk/lunas-ui/features/descriptions';
+ * import { DescriptionCopyAll } from '@customafk/lunas-ui/features/descriptions/components';
+ *
+ * <Description>
+ *   <DescriptionHeader title="Order #1234" extra={<DescriptionCopyAll />} />
+ *   ...
+ * </Description>
+ */
+declare const DescriptionCopyAll: React.FC<DescriptionCopyAllProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/date.d.ts
+type DescriptionDateProps = {
+  date: Date | string | number | null | undefined;
+};
+declare const DescriptionDate: React.FC<DescriptionDateProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/empty.d.ts
+declare const DescriptionEmpty: React.FC;
+//#endregion
+//#region packages/components/features/descriptions/components/file.d.ts
+type DescriptionFileProps = {
+  name: string | null | undefined;
+  /** Download/view URL. Omit while an upload is pending — the filename still renders as inert text. */
+  url?: string | null;
+  /** File size in bytes, shown formatted (KB/MB/...) next to the name. */
+  size?: number | null;
+};
+/**
+ * Filename + optional size, linking to `url` for download when one is available. Only null-guards on
+ * `!name` — a pending/unavailable upload has a name but no `url` yet, and showing the filename as inert
+ * text is more useful than an empty dash.
+ */
+declare const DescriptionFile: React.FC<DescriptionFileProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/images.d.ts
+type ImageItem = {
+  id: string;
+  src: string;
+  alt: string;
+};
+declare const DescriptionImages: React.FC<{
+  images?: Array<ImageItem> | null | undefined;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/json.d.ts
+type DescriptionJsonProps = {
+  value: unknown;
+  /** Max rendered height in px before the block scrolls internally rather than growing the row. @default 240 */
+  maxHeight?: number;
+  /** `JSON.stringify` indent width. @default 2 */
+  indent?: number;
+  /** Renders a click-to-copy button in the top-right corner of the block. @default true */
+  copyable?: boolean;
+};
+/**
+ * Pretty-printed, monospaced JSON viewer for a value inside a `DescriptionItem`. Bounded height + internal
+ * scroll rather than collapsible-by-default — inside a description row the JSON is a *value*, and a value
+ * that's collapsed by default reads as empty. Reach for `DescriptionCollapsibleSection` if you want the
+ * surrounding section itself to start collapsed.
+ */
+declare const DescriptionJson: React.FC<DescriptionJsonProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/link.d.ts
+type DescriptionLinkProps = {
+  href: string | null | undefined;
+  label?: string;
+  external?: boolean;
+  className?: string;
+};
+declare const DescriptionLink: React.FC<DescriptionLinkProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/longtext.d.ts
+declare const DescriptionLongText: React.FC<{
+  content: string | null | undefined | number;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/name.d.ts
+declare const DescriptionName: React.FC<{
+  name?: string | null | undefined;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/number-phone.d.ts
+declare const DescriptionNumberPhone: React.FC<{
+  value?: string | null;
+}>;
+//#endregion
+//#region packages/components/features/descriptions/components/progress.d.ts
+type DescriptionProgressColor = 'primary' | 'success' | 'warning' | 'danger';
+type DescriptionProgressProps = {
+  value: number | null | undefined;
+  /** @default 100 */
+  max?: number;
+  /** @default true */
+  showValue?: boolean;
+  /** Bar thickness. @default 'sm' */
+  size?: 'xs' | 'sm' | 'md';
+  /** @default 'primary' */
+  color?: DescriptionProgressColor;
+};
+/**
+ * Thin-wraps `ui/progress` for use as a description value. `value={0}` renders a (visually empty) bar,
+ * not `DescriptionEmpty` — 0% progress is real information, unlike `DescriptionStatistic`'s `0`-hides-by-default
+ * behavior for currency-like values, where an unset field and a genuine zero amount are indistinguishable.
+ */
+declare const DescriptionProgress: React.FC<DescriptionProgressProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/statistic.d.ts
+declare const descriptionStatisticVariants: (props?: ({
+  size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+  trend?: "neutral" | "up" | "down" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type DescriptionStatisticProps = VariantProps<typeof descriptionStatisticVariants> & {
+  decimalSeparator?: string;
+  groupSeparator?: string;
+  prefix?: React.ReactNode;
+  suffix?: React.ReactNode;
+  precision?: number;
+  roundingMode?: 'round' | 'floor' | 'ceil';
+  showTrailingZeros?: boolean;
+  value: number | string | null | undefined;
+  className?: string;
+  /**
+   * Renders `DescriptionEmpty` for a literal `0` value, same as any other unset/invalid input.
+   * Set to `false` to display a genuine `0` amount instead.
+   * @default true
+   */
+  emptyOnZero?: boolean;
+};
+/**
+ * The value-cell to use for numbers inside a `DescriptionItem` — prefer this over the standalone
+ * `Statistic` (`data-display/statistic`) so empty/invalid values consistently fall back to `DescriptionEmpty`.
+ */
+declare const DescriptionStatistic: import("react").MemoExoticComponent<({ decimalSeparator, groupSeparator, prefix: Prefix, suffix: Suffix, precision, roundingMode, showTrailingZeros, size, trend, value, className, emptyOnZero }: DescriptionStatisticProps) => import("react").JSX.Element>;
+//#endregion
+//#region packages/components/features/descriptions/components/status.d.ts
+type StatusColor = NonNullable<BadgeProps['color']>;
+type DescriptionStatusProps = {
+  label: string | null | undefined;
+  color?: StatusColor;
+  dot?: boolean;
+};
+declare const DescriptionStatus: React.FC<DescriptionStatusProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/tag-list.d.ts
+type DescriptionTagListProps = {
+  tags: Array<string | number> | null | undefined;
+  max?: number;
+  color?: BadgeProps['color'];
+  variant?: BadgeProps['variant'];
+};
+declare const DescriptionTagList: React.FC<DescriptionTagListProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/text.d.ts
+type DescriptionTextProps = {
+  value: string | number | null | undefined;
+  /** `'normal'` (default) or `'medium'` — the two weights used across real detail panels. */
+  weight?: 'normal' | 'medium';
+  /** Clamp to a single line with an ellipsis. @default false */
+  truncate?: boolean;
+  className?: string;
+};
+/**
+ * Plain-text value cell with a built-in `DescriptionEmpty` fallback — use this instead of hand-wrapping
+ * a value in `<p className="text-sm">` (the `DescriptionItem` value slot already applies that styling).
+ *
+ * @example
+ * import { DescriptionItem, DescriptionText } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <DescriptionItem label="Ghi chú">
+ *   <DescriptionText value={order.note} />
+ * </DescriptionItem>
+ */
+declare const DescriptionText: React.FC<DescriptionTextProps>;
+//#endregion
+//#region packages/components/features/descriptions/components/user.d.ts
+type DescriptionUserProps = {
+  uuid?: string | null;
+  username?: string | null;
+  email?: string | null;
+};
+declare const DescriptionUser: React.FC<DescriptionUserProps>;
+//#endregion
+//#region packages/components/features/descriptions/row.d.ts
+/** Column counts that divide 12 evenly, so every cell in a `DescriptionRow` is equal-width. */
+type TDescriptionRowColumns = 1 | 2 | 3 | 4 | 6;
+/**
+ * Number of `DescriptionItem`s laid out per row — a plain number resolves to `{ base: 1, md: N }`
+ * (stacked below 448px, `N`-per-row above), or an object varies it per container-query breakpoint
+ * the same way `UIGrid.cols`/`labelColSpan` do.
+ */
+type TDescriptionRowColumnsConfig = TDescriptionRowColumns | Partial<Record<TUIGridBreakpoint, TDescriptionRowColumns>>;
+/**
+ * Lays a run of `DescriptionItem`s out `columns`-per-row instead of each taking the full row width —
+ * an explicit wrapper rather than auto-detecting consecutive `DescriptionItem` children, so the layout
+ * never depends on how the children happen to be written (`.map()`, a `Fragment`, a conditional, ...).
+ *
+ * Each cell nests its own `UIGrid` (the one `DescriptionItem` already renders internally for its
+ * label/value split) inside this row's `UIGrid` cell — both declare the same named `@container/ui-grid`
+ * context, so the nearer one wins and a squeezed cell's label column resolves against the *cell's* own
+ * width, not the full row's, which is exactly what you want (a half-width cell gets the wider `base: 5`
+ * label share automatically).
+ *
+ * There's no vertical rule between cells by default: with a responsive `columns`, "last cell in a visual
+ * row" isn't knowable in CSS, so a blanket rule would put a stray line flush against the card's own right
+ * edge on every row. Pass `divided` only when every row is known to divide evenly.
+ *
+ * @example
+ * import { Description, DescriptionRow, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionRow columns={2}>
+ *     <DescriptionItem label="First name">John</DescriptionItem>
+ *     <DescriptionItem label="Last name">Doe</DescriptionItem>
+ *   </DescriptionRow>
+ * </Description>
+ */
+declare const DescriptionRow: React.FC<React.PropsWithChildren<{
+  /** @default 2 */
+  columns?: TDescriptionRowColumnsConfig;
+  /** Label column width override for every `DescriptionItem` in this row (they'd otherwise inherit the panel default). */
+  labelColSpan?: TDescriptionLabelColSpan;
+  /** Renders a vertical rule between cells. Only safe when every row has exactly `columns` items. @default false */
+  divided?: boolean;
+  className?: string;
+}>>;
+//#endregion
+//#region packages/components/features/descriptions/search.d.ts
+type DescriptionSearchProps = {
+  /** @default 'Tìm kiếm...' */
+  placeholder?: string;
+  autoFocus?: boolean;
+  className?: string;
+};
+/**
+ * A live, as-you-type filter for a `Description`'s `DescriptionItem`s — no debounce, since matching is a
+ * cheap string test over at most a few dozen items. Place it inside `DescriptionHeader`'s `extra` slot
+ * (the header is sticky by default, so the input stays reachable while scrolling filtered results); it
+ * also works as a direct child of `Description`.
+ *
+ * Filters by case- and diacritic-insensitive substring match against each `DescriptionItem`'s `label` —
+ * this is cross-cutting by design (every sibling item reads the query from context), so no wiring is
+ * needed beyond mounting this component once per panel.
+ *
+ * @example
+ * import { Description, DescriptionHeader, DescriptionSearch } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionHeader title="Order details" extra={<DescriptionSearch />} />
+ *   ...
+ * </Description>
+ */
+declare const DescriptionSearch: React.FC<DescriptionSearchProps>;
+//#endregion
+//#region packages/components/features/descriptions/index.d.ts
+/**
+ * A single labeled row within a {@link Description} container, supporting both horizontal (side-by-side label/value) and vertical (stacked) layouts.
+ *
+ * The label column width defaults to a responsive `{ base: 5, sm: 4, md: 3 }` (out of 12) — wider on narrow
+ * containers like a `SidePanel`, settling to the classic 3/12 from 448px up — and can be overridden per-item
+ * via `labelColSpan`, or for every item in a panel at once via {@link Description}'s own `labelColSpan` prop.
+ * A label that doesn't fit its column truncates to a single line with an ellipsis — never wraps to a second
+ * line — and shows the full text in a tooltip on hover/focus.
+ *
+ * Renders inline `size`/`bordered` inherited from the nearest {@link Description}, and, if placed inside a
+ * {@link DescriptionSearch}-enabled panel, hides itself (`hidden` + `data-search-hidden`) when its `label`
+ * doesn't match the live query — no props needed for this, it's cross-cutting via context.
+ *
+ * @example
+ * import { Description, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionItem label="Full name">John Doe</DescriptionItem>
+ *   <DescriptionItem label="Email" orientation="vertical">john@example.com</DescriptionItem>
+ * </Description>
+ */
+declare const DescriptionItem: React.FC<React.PropsWithChildren<{
+  /** Text displayed in the label column. */
+  label: string;
+  /**
+   * Column width (out of 12) allocated to the label in horizontal orientation. Overrides
+   * whatever the parent {@link Description}'s own `labelColSpan` (or the library default) is.
+   * @default { base: 5, sm: 4, md: 3 }
+   */
+  labelColSpan?: TDescriptionLabelColSpan;
+  /**
+   * Layout direction of the label/value pair.
+   * - `'horizontal'` — label and value are side by side.
+   * - `'vertical'` — label sits above the value.
+   * @default 'horizontal'
+   */
+  orientation?: 'horizontal' | 'vertical';
+  /** Optional node rendered in the top-right corner of the label area (e.g. an edit action). */
+  action?: React.ReactNode;
+  /**
+   * Horizontal alignment of the label text within its column.
+   * @default 'start'
+   */
+  labelAlign?: 'start' | 'end';
+}>>;
+/**
+ * A header bar for a {@link Description} block, showing a title, an optional subtitle, and an optional trailing action area.
+ *
+ * @example
+ * import { Description, DescriptionHeader } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionHeader title="User details" description="Read-only overview" extra={<EditBtn />} />
+ * </Description>
+ */
+declare const DescriptionHeader: React.FC<{
+  /** Primary heading text. */
+  title: string;
+  /** Optional secondary text rendered below the title in a smaller, muted style. */
+  description?: string;
+  /** Optional node rendered on the right side of the header (e.g. action buttons, a {@link DescriptionSearch}). */
+  extra?: React.ReactNode;
+  /**
+   * Sticks the header to the top of its scroll container (`sticky top-0 z-30`). Disable when the
+   * header is rendered inside a non-scrolling context (e.g. a `Dialog`) where stickiness has no effect.
+   * @default true
+   */
+  sticky?: boolean;
+  /** Additional CSS class names applied to the header wrapper. */
+  className?: string;
+}>;
+/**
+ * A visual section divider inside a {@link Description} container that optionally displays a section title with a decorative horizontal rule.
+ *
+ * This flat divider stays always-visible during a {@link DescriptionSearch} filter (it has no ownership of
+ * the items that follow it). Use {@link DescriptionCollapsibleSection} instead when you want a section that
+ * auto-hides once every item inside it is filtered out.
+ *
+ * @example
+ * import { Description, DescriptionSection, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionSection title="Contact" />
+ *   <DescriptionItem label="Email">john@example.com</DescriptionItem>
+ * </Description>
+ */
+declare const DescriptionSection: React.FC<{
+  /** Optional section label rendered as uppercase small-caps text beside the divider line. */
+  title?: string;
+  /** Additional CSS class names applied to the section wrapper. */
+  className?: string;
+}>;
+/**
+ * Root container for a description block — a bordered, rounded card that groups {@link DescriptionHeader}, {@link DescriptionSection}, and {@link DescriptionItem} elements.
+ *
+ * Set `nested` when embedding one `Description` inside another (removes the outer card shadow/ring and constrains sizing).
+ * Set `loading` to replace content with animated skeleton rows while data is being fetched.
+ * Set `labelColSpan` to apply the same label column width to every child `DescriptionItem` at once.
+ * Set `size`/`bordered` to apply the same size scale / border style to every descendant at once — both
+ * inherit from an ancestor `Description`/`DescriptionGroup` when omitted, so a nested panel matches its
+ * parent by default.
+ *
+ * @example
+ * import { Description, DescriptionHeader, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <Description>
+ *   <DescriptionHeader title="Order #1234" />
+ *   <DescriptionItem label="Status">Shipped</DescriptionItem>
+ *   <DescriptionItem label="Total">$99.00</DescriptionItem>
+ * </Description>
+ */
+declare const Description: React.FC<React.PropsWithChildren<{
+  /** Additional CSS class names applied to the root wrapper element. */
+  className?: string;
+  /** Strips the outer card shadow/ring and adapts sizing for embedding inside another Description. */
+  nested?: boolean;
+  /** Replaces children with animated skeleton rows while data is loading. */
+  loading?: boolean;
+  /** Number of skeleton rows shown when `loading` is true (max 24). @default 4 */
+  loadingRows?: number;
+  /** Label column width applied to every child `DescriptionItem` that doesn't set its own `labelColSpan`. */
+  labelColSpan?: TDescriptionLabelColSpan;
+  /** Padding/typography scale for every descendant. Inherits from an ancestor `Description`/`DescriptionGroup` when omitted. @default 'md' */
+  size?: TDescriptionSize;
+  /** Whether the card chrome and every internal grid line render. `false` strips both the outer border and the inner label background/dividers for a flat look. Inherits when omitted. @default true */
+  bordered?: boolean;
+}>>;
+/**
+ * A scrollable container that groups multiple {@link Description} blocks and makes each
+ * {@link DescriptionHeader} sticky. As you scroll, the next section header stacks above
+ * (pushes out) the previous one — standard CSS sticky behaviour within a single scroll context.
+ *
+ * `size`/`bordered` set here cascade to every child `Description` that doesn't set its own.
+ *
+ * @example
+ * import { DescriptionGroup, Description, DescriptionHeader, DescriptionItem } from '@customafk/lunas-ui/features/descriptions';
+ *
+ * <DescriptionGroup>
+ *   <Description>
+ *     <DescriptionHeader title="Personal info" />
+ *     <DescriptionItem label="Name">John Doe</DescriptionItem>
+ *   </Description>
+ *   <Description>
+ *     <DescriptionHeader title="Contact" />
+ *     <DescriptionItem label="Email">john@example.com</DescriptionItem>
+ *   </Description>
+ * </DescriptionGroup>
+ */
+declare const DescriptionGroup: React.FC<React.PropsWithChildren<{
+  /** Additional CSS class names applied to the group wrapper. */
+  className?: string;
+  /** Applied to every child `Description` that doesn't set its own. @default 'md' */
+  size?: TDescriptionSize;
+  /** Applied to every child `Description` that doesn't set its own. @default true */
+  bordered?: boolean;
+}>>;
+//#endregion
+export { descriptionItemValueVariants as $, DescriptionBadge as A, TDescriptionLabelSpan as B, DescriptionFile as C, DescriptionCopy as D, DescriptionCopyAll as E, DescriptionRowContext as F, DescriptionItemVariants as G, TDescriptionSectionScope as H, DescriptionSearchContext as I, descriptionGroupVariants as J, DescriptionVariants as K, DescriptionSectionScopeContext as L, DESCRIPTION_CONFIG_DEFAULT as M, DescriptionConfigContext as N, DescriptionColor as O, DescriptionGroupContext as P, descriptionItemLabelVariants as Q, TDescriptionConfig as R, DescriptionImages as S, DescriptionDate as T, DESCRIPTION_LAST_ROW_SELECTOR as U, TDescriptionSearch as V, DescriptionHeaderVariants as W, descriptionHeaderTitleVariants as X, descriptionHeaderDescriptionVariants as Y, descriptionHeaderVariants as Z, DescriptionNumberPhone as _, DescriptionSection as a, DescriptionLink as b, TDescriptionRowColumns as c, DescriptionText as d, descriptionItemVariants as et, DescriptionTagList as f, DescriptionProgress as g, DescriptionStatisticProps as h, DescriptionItem as i, DescriptionCollapsibleSection as j, DescriptionBoolean as k, TDescriptionRowColumnsConfig as l, DescriptionStatistic as m, DescriptionGroup as n, descriptionSectionVariants as nt, DescriptionSearch as o, DescriptionStatus as p, TDescriptionSize as q, DescriptionHeader as r, descriptionVariants as rt, DescriptionRow as s, Description as t, descriptionRowVariants as tt, DescriptionUser as u, DescriptionName as v, DescriptionEmpty as w, DescriptionJson as x, DescriptionLongText as y, TDescriptionLabelColSpan as z };
+//# sourceMappingURL=index-Cp4Db57w.d.cts.map