import { IRChild } from '@retikz/core';
import { ExternalRow } from '@retikz/data';
import { z } from 'zod';
import { IRPlotMark, IRPlotMarkOperation } from '../schemas';
import { MarkLoweringContext } from './anchor';
import { ChannelDefinitionKindValue, FieldCollector, MarkChannels } from './channel';
import { Cell, CoordinateFrame } from './coordinate';
/**
 * 区间柱（interval mark）摆放上下文：lowering 与 locator 共享的一次性派生量
 * @description 每 mark 构造一次（buildIntervalContext），随后逐行复用——把 band group 的子带划分
 *   （seriesRank / subWidth）收进一处，杜绝两处各算各的漂移。堆叠经 extent bounds 表达、不再走 ctx
 */
export type IntervalContext = {
    /** 按 role 保存的 band 子带上下文；仅 interval lowering / locator 共享，不进 IR */
    byRole: Partial<Record<string, {
        /** 类别带宽（group 切子带、plain 直接用） */
        bandwidth: number;
        /** band group 子带字段（bounds.<role> = band{group} 时有值；否则 undefined = 整带） */
        group?: string;
        /** group 值 → 子带序号（按数据序去重推断，与 lowering 一致） */
        seriesRank: Map<string | number, number>;
        /** 单子带宽（bandwidth / 子带数；无 group 下 = bandwidth） */
        subWidth: number;
    }>>;
    /** 按 role 保存的比例宽度累积区间；供 variable-width interval lowering / locator 共享，不进 IR */
    proportionalByRole?: Partial<Record<string, Map<ExternalRow, [number, number]>>>;
};
/**
 * mark lowering 行为注册项（按 type 查找分发；行为函数不进 IR）
 * @description Plot mark schema 仍是 JSON IR 的静态单一真源；本接口只承载「某 mark type 怎么下沉成 core IR」的行为，
 *   对齐仓库已有的 composite / coordinate / transform / scale 工厂注册范式。内置与自定义 mark 都经同一 registry 分派
 */
export type MarkDefinition<T extends IRPlotMarkOperation = IRPlotMark> = {
    /** 完整 mark operation schema；必须含非空 `z.literal('type')` 供 registry 提取注册键 */
    schema: z.ZodType<T>;
    /** 收集该 mark 额外引用的用户源字段；通用 encoding / label 字段由 data 层统一处理 */
    collectFields?: (mark: T, fields: FieldCollector) => void;
    /**
     * 声明该 mark 能消费哪些通道交付面。
     * @description channel registry 会据此只解析 mark 实际会下沉的 channel definition。比如 point 可消费 mark / scope / node
     *   通道，path 可消费 mark / scope / path 通道；自定义 mark 应按自己的 lowering 产物声明，避免 channel 层写死 mark type
     */
    channelKinds?: (mark: T) => ReadonlySet<ChannelDefinitionKindValue>;
    /** 区间类 mark：某行 → 正交 Cell（interval 用；非区间类省略） */
    buildCell?: (mark: T, row: ExternalRow, frame: CoordinateFrame, ctx?: IntervalContext) => Cell | null;
    /** 下沉到 core IR 图层（无可绘制图元返回 null；不支持的 mark × coordinate 由实现 fail-loud） */
    lower: (mark: T, rows: Array<ExternalRow>, frame: CoordinateFrame, channels: MarkChannels, ctx?: MarkLoweringContext) => IRChild | null;
};
/**
 * 定义一个 mark definition。
 * @description 保留 collectFields / buildCell / lower 之间对 mark 子类型的强类型关联；内置与自定义 mark 都经同一 registry 入口分派。
 * @remarks 当前 helper 只做 `MarkDefinition` 类型约束并原样返回定义对象；保留稳定入口是为了与其它 registry API 对齐，并为后续运行时校验、默认值归一或泛型收敛预留 contract hook
 */
export declare const defineMark: <T extends IRPlotMarkOperation = IRPlotMark>(def: MarkDefinition<T>) => MarkDefinition<T>;
/**
 * 从 mark definition schema 中提取 registry key。
 * @description schema 必须是含 `type: z.literal('<mark-type>')` 的 ZodObject；literal 值同时是 IR 判别串与 registry 唯一键
 */
export declare const extractMarkType: (schema: z.ZodType) => string;
/**
 * registry 内部使用的宽类型。
 * @description registry 需要存放不同 mark 子类型的 definition；真正调用前由 lowerMark 按 type 取出，行为函数入参用 never 防误调
 */
export type AnyMarkDefinition = {
    /** 不同 definition 的 schema 泛型不同，registry 只关心 type 提取与运行时 parse */
    schema: z.ZodType;
    /** 内部宽类型占位；按 type 取出后调用方已知具体 mark */
    collectFields?: (mark: never, fields: FieldCollector) => void;
    /** 内部宽类型占位；语义同 MarkDefinition.channelKinds，供 registry 按 type 分发后调用 */
    channelKinds?: (mark: never) => ReadonlySet<ChannelDefinitionKindValue>;
    /** 内部宽类型占位；按 type 取出后调用方已知具体 mark */
    buildCell?: (mark: never, row: ExternalRow, frame: CoordinateFrame, ctx?: IntervalContext) => Cell | null;
    /** 内部宽类型占位；按 type 取出后调用方已知具体 mark */
    lower: (mark: never, rows: Array<ExternalRow>, frame: CoordinateFrame, channels: MarkChannels, ctx?: MarkLoweringContext) => IRChild | null;
};
//# sourceMappingURL=mark.d.ts.map