import { ReactNode } from 'react';
/**
 * 卡片数据 - 插件只提供数据，渲染统一
 */
export interface LinkCardData {
    /** 高亮/主题色 (hex 格式) */
    color?: string;
    /** 卡片描述 */
    desc?: ReactNode;
    /** 图片 URL */
    image?: string;
    /** 卡片标题 */
    title: ReactNode;
}
/**
 * URL 匹配结果
 */
export interface UrlMatchResult {
    /** 完整 URL（用于链接跳转） */
    fullUrl?: string;
    /** 解析后的 ID */
    id: string;
    /** 额外元数据 */
    meta?: Record<string, unknown>;
}
/**
 * 请求适配器：由业务方注入具体请求策略（鉴权、代理、限流兜底、重试等）
 */
export interface LinkCardApiAdapter {
    request: <T = unknown>(input: string, init?: RequestInit) => Promise<T>;
}
/**
 * LinkCard fetch 运行时上下文
 */
export interface LinkCardFetchContext {
    /**
     * 按 provider 注入请求适配器
     * 例如: { github: { request: ... }, tmdb: { request: ... } }
     */
    adapters?: Record<string, LinkCardApiAdapter>;
    /**
     * 全局默认 fetcher（当 provider 适配器不存在时使用）
     */
    fetchJson?: <T = unknown>(input: string, init?: RequestInit) => Promise<T>;
}
/**
 * 卡片形状（layout shape）
 * - compact:  默认横版小图，标题 + 双行 desc
 * - expanded: 较宽，三行 desc（长摘要场景）
 * - wide:     全宽，多行块状 desc（音乐 / 题目）
 * - poster:   全宽 + 直立海报图（影 / 番剧）
 */
export type LinkCardShape = 'compact' | 'expanded' | 'wide' | 'poster';
/**
 * 插件接口 - 每个插件自包含
 */
export interface LinkCardPlugin<TMeta = Record<string, unknown>> {
    /** 可读名称（调试/文档用） */
    readonly displayName: string;
    /**
     * 获取卡片数据
     * @param id - 解析后的标识符
     * @param meta - URL 匹配时的元数据
     * @param context - 运行时上下文（请求适配器、全局 fetcher 等）
     */
    fetch: (id: string, meta?: TMeta, context?: LinkCardFetchContext) => Promise<LinkCardData>;
    /**
     * 验证 ID 格式（支持显式 source 用法）
     */
    isValidId: (id: string) => boolean;
    /**
     * 匹配 URL
     * @returns 匹配结果或 null
     */
    matchUrl: (url: URL) => UrlMatchResult | null;
    /** 唯一标识符 */
    readonly name: string;
    /** URL 匹配优先级（越高越先匹配） */
    readonly priority?: number;
    /** 插件依赖的 provider 名称，用于路由到对应请求适配器 */
    readonly provider?: string;
    /** 卡片形状 */
    readonly shape?: LinkCardShape;
}
/**
 * 插件注册表类型
 */
export type PluginRegistry = readonly LinkCardPlugin[];
//# sourceMappingURL=types.d.ts.map