类型定义

type Bounds = {x: number; y: number; width: number; height: number};

interface JSXElement {
  type: string | symbol | ((props?: any) => JSXNode); // 节点类型
  props: Record<string, any>; // 属性对象
  key?: string | null; // 可选稳定标识
}

type JSXNode =
  | JSXElement
  | string
  | number
  | boolean
  | null
  | undefined
  | JSXNode[];

type ComponentType<P = {}> = (props: P & {children?: JSXNode}) => JSXNode; // 输入包含 children，输出 JSXNode

type Padding = number | number[];

type ExportOptions = SVGExportOptions | PNGExportOptions;

type ItemOptions = Partial<BaseItemProps>;

interface Item<T extends BaseItemProps = BaseItemProps> {
  component: ComponentType<T>; // 用于渲染的组件
  composites: string[]; // 可组合的结构类型
  options?: ItemOptions; // 默认项配置
}

interface BaseStructureProps {
  Title?: ComponentType<Pick<TitleProps, 'title' | 'desc'>>; // 可选标题组件
  Item: ComponentType<
    Omit<BaseItemProps, 'themeColors'> &
      Partial<Pick<BaseItemProps, 'themeColors'>>
  >; // 当前层级数据项组件
  Items: ComponentType<Omit<BaseItemProps, 'themeColors'>>[]; // 按层级选择的数据项组件列表
  data: Data; // 完整数据
  options: ParsedInfographicOptions; // 解析后的配置
}

interface Structure {
  component: ComponentType<BaseStructureProps>; // 结构组件实现
  composites: string[]; // 结构包含组成部分，用于为 AI 生成类型说明
}

type StructureOptions = Record<string, any>;

type FontWeightName =
  | 'thin'
  | 'extralight'
  | 'light'
  | 'regular'
  | 'medium'
  | 'semibold'
  | 'bold'
  | 'extrabold'
  | 'black'
  | 'extrablack';

interface Font {
  fontFamily: string; // 字体族名
  name: string; // 展示用名称
  baseUrl: string; // 字体文件基地址或 CSS 地址
  fontWeight: {[keys in FontWeightName]?: string}; // 各字重映射到实际资源
}

type ElementProps = GeometryProps | TextProps;

interface GeometryProps {
  type:
    | 'rectangle'
    | 'circle'
    | 'ellipse'
    | 'line'
    | 'polyline'
    | 'polygon'
    | 'path'
    | 'image';
  attributes: Record<string, any>;
}

interface TextProps {
  type: 'text';
  textContent: string;
  attributes: TextAttributes;
}

interface IPlugin {
  name: string;
  init(options: {
    emitter: any;
    editor: any;
    commander: any;
    plugin: any;
    state: any;
  }): void;
  destroy(): void;
}

interface IInteraction {
  name: string;
  init(options: {emitter: any; editor: any; commander: any; interaction: any}): void;
  destroy(): void;
}

type ResourceLoader = (
  config: ResourceConfig
) => Promise<SVGSymbolElement | null>;

type DynamicAttributes<T extends object> = {
  [key in keyof T]?:
    | T[key]
    | ((value: T[key], node: SVGElement) => T[key] | undefined);
};

type Palette =
  | string
  | string[]
  | ((ratio: number, index: number, count: number) => string);

type StylizeConfig = RoughConfig | PatternConfig | GradientConfig;

type GradientConfig = LinearGradient | RadialGradient;

type TemplateOptions = Omit<
  InfographicOptions,
  'container' | 'template' | 'data'
>;

type WithType\<T\> = T & {type: string};

type WithProps<T, P = any> = T & {props?: P};