/**
 * @file MetadataList.tsx
 * @input Uses React, ReactNode, StyleXStyles, theme tokens, MetadataListContext, i18n (useTranslator)
 * @output Exports MetadataList component, MetadataListProps, MetadataListColumns types
 * @position Core implementation; consumed by index.ts, tested by MetadataList.test.tsx
 *
 * SYNC: When modified, update these files to stay in sync:
 * - /packages/core/src/MetadataList/MetadataList.doc.mjs
 * - /packages/core/src/MetadataList/MetadataList.test.tsx
 * - /packages/core/src/MetadataList/index.ts
 * - /apps/storybook/stories/MetadataList.stories.tsx
 * - /packages/cli/assets/templates/blocks/components/MetadataList/ (showcase blocks)
 */
import { type ReactNode } from 'react';
import { type MetadataListLabelConfig } from './MetadataListContext';
import type { BaseProps } from '../BaseProps';
export type MetadataListColumns = 'multi' | 'single' | number;
export interface MetadataListProps extends Omit<BaseProps<HTMLDivElement>, 'title'> {
    /** Ref forwarded to the root element */
    ref?: React.Ref<HTMLDivElement>;
    /**
     * Metadata list items. Should be MetadataListItem components.
     */
    children: ReactNode;
    /**
     * Column layout mode.
     * - 'single': Items in a single column
     * - 'multi': Auto-fill columns based on available width
     * - number: Fixed number of columns
     * @default 'single'
     */
    columns?: MetadataListColumns;
    /**
     * Label display configuration.
     * - position: 'start' places labels to the left, 'top' stacks labels above content
     * - width: Custom label width (number in px or CSS string)
     *
     * Defaults to `{ position: 'top' }` for multi-column layouts and
     * `{ position: 'start' }` for single-column layouts.
     */
    label?: MetadataListLabelConfig;
    /**
     * Maximum number of items to show before collapsing.
     * When set and items exceed this count, a "Show more" / "Show less"
     * toggle appears.
     */
    maxNumOfItems?: number;
    /**
     * Layout orientation for metadata items.
     * - 'vertical': Items stack vertically (default)
     * - 'horizontal': Items flow horizontally with flex-wrap
     *
     * In horizontal mode, items display with labels stacked above content
     * and wrap to new lines as needed. The following props are ignored:
     * `columns`, `label`, `maxNumOfItems`.
     * @default 'vertical'
     */
    orientation?: 'vertical' | 'horizontal';
    /**
     * Optional title or heading rendered above the list.
     */
    title?: ReactNode;
    /**
     * Test ID for testing frameworks.
     */
    'data-testid'?: string;
}
export declare function MetadataList({ children, columns, label, maxNumOfItems, orientation, title, xstyle, className, style, 'data-testid': testId, ref, }: MetadataListProps): import("react").JSX.Element;
export declare namespace MetadataList {
    var displayName: string;
}
//# sourceMappingURL=MetadataList.d.ts.map