import { IRArrowDetail, IRPath, PathThicknessValue } from '@retikz/core';
import { FC, ReactNode } from 'react';
import { HydrationEventProps } from '../protocol';
export type PathArrowDirectionValue = 'none' | '->' | '<-' | '<->';
export type PathProps = HydrationEventProps & {
    kind?: IRPath['kind'];
    kindOptions?: IRPath['kindOptions'];
    ribbon?: IRPath['ribbon'];
    label?: IRPath['label'];
    /** 路径 id；其他 path / position 通过这个 id 引用本路径，也作为水合挂点供事件 handler 绑定 */
    id?: IRPath['id'];
    /** 用户自定义元数据；可在事件 / 水合上下文中读取，不参与布局。须为 JSON 可序列化对象 */
    meta?: IRPath['meta'];
    /** 路径级时间轴动画；渲染端播放或降级为静态，不参与布局 */
    animations?: IRPath['animations'];
    /** 主色（TikZ `color=`）；stroke / 箭头 / step label 未单设则随它（跟主色不跟 stroke） */
    color?: IRPath['color'];
    /** 描边色，省略时用 currentColor */
    stroke?: IRPath['stroke'];
    /** 描边宽度，省略时为 1 */
    strokeWidth?: IRPath['strokeWidth'];
    /** 描边 dash pattern（如 [4, 2]） */
    dashPattern?: IRPath['dashPattern'];
    /** 描边 dash offset */
    dashOffset?: IRPath['dashOffset'];
    /** 端点形状（TikZ `line cap`）：`'butt'`（默认 / 直角）/ `'round'`（半圆）/ `'square'`（方头外扩半 stroke） */
    lineCap?: IRPath['lineCap'];
    /** 拐点形状（TikZ `line join`）：`'miter'`（默认 / 尖角）/ `'round'`（圆角）/ `'bevel'`（切角） */
    lineJoin?: IRPath['lineJoin'];
    /**
     * 折线拐角几何圆角半径（TikZ `rounded corners=`）
     * @description 对每个 line↔line 接缝插切圆弧、改路径几何（区别于 lineJoin 仅描边）；curve / arc / bezier / fold 接缝保持尖；按相邻段长 clamp；省略 = 尖角
     */
    roundedCorners?: IRPath['roundedCorners'];
    /** 语义 stroke 档位糖（TikZ `ultra thin` … `ultra thick`）；构造 IR 时解析为 `strokeWidth`，显式 `strokeWidth` 始终优先 */
    thickness?: PathThicknessValue;
    /**
     * 路径级箭头方向
     * @description `'->'` 终点 / `'<-'` 起点 / `'<->'` 两端；省略或 `'none'` 无箭头
     */
    arrow?: PathArrowDirectionValue;
    /**
     * 箭头详细配置
     * @description 顶层默认 + 可选 `start` / `end` 子对象逐字段 merge override。空心 shape
     *   （open / openStealth / openDiamond / openCircle）上 `fill` silent no-op
     */
    arrowDetail?: IRArrowDetail;
    /** 闭合区域填充色，CSS 颜色字符串；省略 = 不填充（仅描边）。配合 cycle step 画填充形状 */
    fill?: IRPath['fill'];
    /** 填充规则：`'nonzero'`（默认）/ `'evenodd'`（环形 / 孔洞） */
    fillRule?: IRPath['fillRule'];
    /** 整 path 透明度 0~1；同时作用于 stroke 与 fill */
    opacity?: IRPath['opacity'];
    /** 仅 fill 透明度 0~1 */
    fillOpacity?: IRPath['fillOpacity'];
    /** 仅 stroke 透明度 0~1（TikZ `stroke opacity`） */
    strokeOpacity?: IRPath['strokeOpacity'];
    /** 主路径投影；不影响 step label、沿线标记或端点箭头。预设字符串或对象均可，显式字段覆盖 preset */
    shadow?: IRPath['shadow'];
    /** 主路径混合模式（与下方已绘内容混合，W3C 分离模式）；不含 step label / marks / arrows。省略 / `normal` = 普通 source-over */
    blendMode?: IRPath['blendMode'];
    /** 显式栈序：大者在上；缺省 0 = 声明顺序；同值稳定保序；只在同层子节点间生效 */
    zIndex?: IRPath['zIndex'];
    /**
     * 整条 path 旋转（度，绕包围盒中心，正向 = 屏幕 y-down 视觉顺时针）
     * @description 等价把 path 包一层绕其包围盒中心旋转的 Scope；端点先在当前 scope resolve 再整体旋转
     */
    rotate?: IRPath['rotate'];
    /**
     * 整条 path 缩放（绕包围盒中心）：number 等比，或 `{ x, y }` 非等比
     */
    scale?: IRPath['scale'];
    /**
     * 沿路径在归一化位置放标记（首批仅箭头）
     * @description 每个 `{ pos, mark }`：`pos∈[0,1]`，`mark.kind:'arrow'` + 视觉子集（shape 为已注册箭头名，方向随路径切线）
     */
    marks?: IRPath['marks'];
    /** 应当全部是 <Step /> */
    children?: ReactNode;
};
/**
 * Path 用一组 `<Step>` 声明路径
 * @description 本组件自身不渲染 DOM；最终路径由 `<Layout>` 根据 step 序列、样式、箭头和标记输出
 */
export declare const Path: FC<PathProps>;
//# sourceMappingURL=Path.d.ts.map