import React from 'react';
import { type DocCardsFieldMap } from './utils';
/**
 * DocCards 组件 - 文档型卡片栅格
 *
 * 与现有图表共用同一套「HTML 注释 + GFM 表格」数据契约：
 *
 * - 一行 Markdown 表格 = 一张卡片；
 * - 表头列名按约定语义解析为 `title`/`url`/`description`/`tags`，可通过 `fieldMap` 覆盖；
 * - `cardColumns` 控制每行卡片数（1~4，默认 2）；窄屏（< 480px）强制单列。
 *
 * 解析无法定位 `title` 列时渲染带本地化文案的空态占位（i18n 键 `docCards`）；
 * 在 Markdown 路径下，上层 `parseTable` 已做过整表降级，此分支主要服务于
 * 直接消费 `DocCards` 组件且数据列名不规范的场景。
 */
export interface DocCardsProps {
    /** 标题，对应注释中的 `title` 字段；为空时不渲染 header */
    title?: React.ReactNode;
    /** 表头列定义（与 ChartRender 接口一致） */
    columns: {
        title?: string;
        dataIndex: string;
        key?: string;
    }[];
    /** 已转好的数据行（与 chart 走同一份 dataSource） */
    data: Record<string, any>[];
    /** 工具栏额外节点（同 header 行右对齐） */
    toolbar?: React.ReactNode;
    /** 自定义字段名 → 表头 dataIndex 的映射 */
    fieldMap?: DocCardsFieldMap;
    /**
     * 每行卡片数，取值 `1`/`2`/`3`/`4`；缺省 `2`，传入 `1` 时呈现单列全宽列表。
     * `< 480px` viewport 通过媒体查询强制单列，确保移动端可读。
     */
    cardColumns?: number;
    /** 容器自定义类名 */
    className?: string;
    /** 容器自定义样式 */
    style?: React.CSSProperties;
}
export declare const DocCards: React.NamedExoticComponent<DocCardsProps>;
