rendx-shape 0.1.0

package/dist/main.d.cts

@@ -0,0 +1,229 @@
+import { Path } from 'rendx-path';
+
+/** 圆形配置 */
+interface CircleOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 半径 */
+    r: number;
+}
+/** 生成圆形 SVG 路径（两段弧组成完整圆） */
+declare const createCircle: (path: Path, { cx, cy, r }: CircleOptions) => void;
+
+/** 矩形配置 */
+interface RectOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** 圆角 X 半径（数字为统一圆角，4元素数组为独立圆角 [tl, tr, br, bl]） */
+    rx?: number | number[];
+    /** 圆角 Y 半径 */
+    ry?: number | number[];
+}
+declare const createRectNormal: (path: Path, { x, y, width, height }: RectOptions) => void;
+declare const createRectRounded: (path: Path, { x, y, width, height, rx, ry }: RectOptions) => void;
+/** 生成矩形路径（自动根据 rx/ry 选择普通或圆角矩形） */
+declare const createRect: (path: Path, options: RectOptions) => void;
+
+/** 弧线配置 */
+interface ArcOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 基准半径 */
+    r: number;
+    /** 起始角度（弧度） */
+    startAngle: number;
+    /** 结束角度（弧度） */
+    endAngle: number;
+    /** 弧线半径比例 (0~1) */
+    radius: number;
+}
+/** 生成弧线路径（超过 2π 自动降级为完整圆） */
+declare const createArc: (path: Path, options: ArcOptions) => void;
+
+interface RingOptions {
+    cx: number;
+    cy: number;
+    r: number;
+    innerRadius: number;
+    outerRadius: number;
+}
+declare const createRing: (path: Path, options: RingOptions) => void;
+
+/** 扇形配置 */
+interface SectorOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 基准半径 */
+    r: number;
+    /** 起始角度（弧度） */
+    startAngle: number;
+    /** 结束角度（弧度） */
+    endAngle: number;
+    /** 扇形间 pad 角度 */
+    padAngle?: number;
+    /** 内半径比例 (0~1) */
+    innerRadius: number;
+    /** 外半径比例 (0~1) */
+    outerRadius: number;
+    /** 圆角半径（数字为统一，4元素数组为 [outerLeft, innerLeft, outerRight, innerRight]） */
+    rc?: number | number[];
+}
+declare const createSectorNormal: (path: Path, options: SectorOptions) => void;
+declare const createSectorRounded: (path: Path, options: SectorOptions) => void;
+declare const createSector: (path: Path, options: SectorOptions) => void;
+
+/** 折线配置 */
+interface LineOptions {
+    /** 曲线插值类型（'linear' | 'natural' | 'monotone' 等，默认 'linear'） */
+    curve?: string;
+    /** 是否闭合 */
+    closed?: boolean;
+    /** 端点坐标序列 */
+    points: [number, number][];
+}
+interface SegmentLineOptions {
+    curve?: string;
+    closed?: boolean;
+    segments: [number, number][][];
+}
+/** 生成折线路径（支持曲线插值） */
+declare const createLine: (path: Path, options: LineOptions) => void;
+/** 生成分段折线路径（多段独立折线） */
+declare const createSegmentLine: (path: Path, options: SegmentLineOptions) => void;
+
+/** 面积图配置 */
+interface AreaOptions {
+    /** 上边界点序列 */
+    upperPoints: [number, number][];
+    /** 下边界点序列 */
+    lowerPoints: [number, number][];
+    /** 统一曲线插值类型（默认 'linear'） */
+    curve?: string;
+    closed?: boolean;
+    /** 上边界曲线类型（覆盖 curve） */
+    upperCurve?: string;
+    /** 下边界曲线类型（覆盖 curve） */
+    lowerCurve?: string;
+}
+interface SegmentAreaOptions {
+    upperSegments: [number, number][][];
+    lowerSegments: [number, number][][];
+    curve?: string;
+    upperCurve?: string;
+    lowerCurve?: string;
+}
+/** 生成面积图路径（上下边界 + 曲线插值） */
+declare const createArea: (path: Path, options: AreaOptions) => void;
+declare const createSegmentArea: (path: Path, options: SegmentAreaOptions) => void;
+
+interface BoxXOptions {
+    cx: number;
+    minY: number;
+    maxY: number;
+    q1Y: number;
+    q2Y: number;
+    q3Y: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface BoxYOptions {
+    cy: number;
+    minX: number;
+    maxX: number;
+    q1X: number;
+    q2X: number;
+    q3X: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare const createBoxX: (path: Path, options: BoxXOptions) => void;
+declare const createBoxY: (path: Path, options: BoxYOptions) => void;
+
+interface ShapeOptionsMap {
+    circle: CircleOptions;
+    rect: RectOptions;
+    arc: ArcOptions;
+    sector: SectorOptions;
+    line: LineOptions;
+    segmentLine: SegmentLineOptions;
+    area: AreaOptions;
+    segmentArea: SegmentAreaOptions;
+    boxX: BoxXOptions;
+    boxY: BoxYOptions;
+}
+type ShapeType = keyof ShapeOptionsMap;
+/**
+ * 统一形状工厂：按类型名分发到对应的形状生成器
+ * @param path - Path 实例（用于写入路径命令）
+ * @param type - 形状类型（circle/rect/arc/sector/line/area 等）
+ * @param options - 对应形状的配置参数
+ *
+ * @example
+ * ```ts
+ * const path = new Path();
+ * createShape(path, 'circle', { cx: 100, cy: 100, r: 50 });
+ * console.log(path.toString()); // SVG path string
+ * ```
+ */
+declare const createShape: <T extends ShapeType>(path: Path, type: T, options: ShapeOptionsMap[T]) => void;
+
+interface SymbolOptions {
+    cx: number;
+    cy: number;
+    r: number;
+}
+type SymbolCreator = (path: Path, options: SymbolOptions) => void;
+
+declare const createCircleSymbol: SymbolCreator;
+
+declare const createCrossSymbol: SymbolCreator;
+
+declare const createDiamondSymbol: SymbolCreator;
+
+declare const createSquareSymbol: SymbolCreator;
+
+declare const createStarSymbol: SymbolCreator;
+
+declare const createUpTriangleSymbol: SymbolCreator;
+declare const createDownTriangleSymbol: SymbolCreator;
+declare const createLeftTriangleSymbol: SymbolCreator;
+declare const createRightTriangleSymbol: SymbolCreator;
+declare const createTriangleSymbol: SymbolCreator;
+declare const createInvertedTriangleSymbol: SymbolCreator;
+
+declare const createWyeSymbol: SymbolCreator;
+
+declare const createHLineSymbol: SymbolCreator;
+declare const createVLineSymbol: SymbolCreator;
+
+declare const createEyeSymbol: SymbolCreator;
+declare const createClosedEyeSymbol: SymbolCreator;
+
+declare const createResetSymbol: SymbolCreator;
+
+declare const createSelectSymbol: SymbolCreator;
+
+declare const fillSymbols: string[];
+declare const createSymbol: (path: Path, symbol: string, options: SymbolOptions) => void;
+
+interface IndicatorBoxOptions {
+    anchor: 'top' | 'bottom' | 'left' | 'right';
+    anchorSize: number;
+    width: number;
+    height: number;
+}
+declare const createIndicatorBox: (path: Path, options: IndicatorBoxOptions) => void;
+
+export { type ArcOptions, type AreaOptions, type BoxXOptions, type BoxYOptions, type CircleOptions, type IndicatorBoxOptions, type LineOptions, type RectOptions, type RingOptions, type SectorOptions, type SegmentAreaOptions, type SegmentLineOptions, type SymbolCreator, type SymbolOptions, createArc, createArea, createBoxX, createBoxY, createCircle, createCircleSymbol, createClosedEyeSymbol, createCrossSymbol, createDiamondSymbol, createDownTriangleSymbol, createEyeSymbol, createHLineSymbol, createIndicatorBox, createInvertedTriangleSymbol, createLeftTriangleSymbol, createLine, createRect, createRectNormal, createRectRounded, createResetSymbol, createRightTriangleSymbol, createRing, createSector, createSectorNormal, createSectorRounded, createSegmentArea, createSegmentLine, createSelectSymbol, createShape, createSquareSymbol, createStarSymbol, createSymbol, createTriangleSymbol, createUpTriangleSymbol, createVLineSymbol, createWyeSymbol, fillSymbols };

package/dist/main.d.ts

@@ -0,0 +1,229 @@
+import { Path } from 'rendx-path';
+
+/** 圆形配置 */
+interface CircleOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 半径 */
+    r: number;
+}
+/** 生成圆形 SVG 路径（两段弧组成完整圆） */
+declare const createCircle: (path: Path, { cx, cy, r }: CircleOptions) => void;
+
+/** 矩形配置 */
+interface RectOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** 圆角 X 半径（数字为统一圆角，4元素数组为独立圆角 [tl, tr, br, bl]） */
+    rx?: number | number[];
+    /** 圆角 Y 半径 */
+    ry?: number | number[];
+}
+declare const createRectNormal: (path: Path, { x, y, width, height }: RectOptions) => void;
+declare const createRectRounded: (path: Path, { x, y, width, height, rx, ry }: RectOptions) => void;
+/** 生成矩形路径（自动根据 rx/ry 选择普通或圆角矩形） */
+declare const createRect: (path: Path, options: RectOptions) => void;
+
+/** 弧线配置 */
+interface ArcOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 基准半径 */
+    r: number;
+    /** 起始角度（弧度） */
+    startAngle: number;
+    /** 结束角度（弧度） */
+    endAngle: number;
+    /** 弧线半径比例 (0~1) */
+    radius: number;
+}
+/** 生成弧线路径（超过 2π 自动降级为完整圆） */
+declare const createArc: (path: Path, options: ArcOptions) => void;
+
+interface RingOptions {
+    cx: number;
+    cy: number;
+    r: number;
+    innerRadius: number;
+    outerRadius: number;
+}
+declare const createRing: (path: Path, options: RingOptions) => void;
+
+/** 扇形配置 */
+interface SectorOptions {
+    /** 圆心 X */
+    cx: number;
+    /** 圆心 Y */
+    cy: number;
+    /** 基准半径 */
+    r: number;
+    /** 起始角度（弧度） */
+    startAngle: number;
+    /** 结束角度（弧度） */
+    endAngle: number;
+    /** 扇形间 pad 角度 */
+    padAngle?: number;
+    /** 内半径比例 (0~1) */
+    innerRadius: number;
+    /** 外半径比例 (0~1) */
+    outerRadius: number;
+    /** 圆角半径（数字为统一，4元素数组为 [outerLeft, innerLeft, outerRight, innerRight]） */
+    rc?: number | number[];
+}
+declare const createSectorNormal: (path: Path, options: SectorOptions) => void;
+declare const createSectorRounded: (path: Path, options: SectorOptions) => void;
+declare const createSector: (path: Path, options: SectorOptions) => void;
+
+/** 折线配置 */
+interface LineOptions {
+    /** 曲线插值类型（'linear' | 'natural' | 'monotone' 等，默认 'linear'） */
+    curve?: string;
+    /** 是否闭合 */
+    closed?: boolean;
+    /** 端点坐标序列 */
+    points: [number, number][];
+}
+interface SegmentLineOptions {
+    curve?: string;
+    closed?: boolean;
+    segments: [number, number][][];
+}
+/** 生成折线路径（支持曲线插值） */
+declare const createLine: (path: Path, options: LineOptions) => void;
+/** 生成分段折线路径（多段独立折线） */
+declare const createSegmentLine: (path: Path, options: SegmentLineOptions) => void;
+
+/** 面积图配置 */
+interface AreaOptions {
+    /** 上边界点序列 */
+    upperPoints: [number, number][];
+    /** 下边界点序列 */
+    lowerPoints: [number, number][];
+    /** 统一曲线插值类型（默认 'linear'） */
+    curve?: string;
+    closed?: boolean;
+    /** 上边界曲线类型（覆盖 curve） */
+    upperCurve?: string;
+    /** 下边界曲线类型（覆盖 curve） */
+    lowerCurve?: string;
+}
+interface SegmentAreaOptions {
+    upperSegments: [number, number][][];
+    lowerSegments: [number, number][][];
+    curve?: string;
+    upperCurve?: string;
+    lowerCurve?: string;
+}
+/** 生成面积图路径（上下边界 + 曲线插值） */
+declare const createArea: (path: Path, options: AreaOptions) => void;
+declare const createSegmentArea: (path: Path, options: SegmentAreaOptions) => void;
+
+interface BoxXOptions {
+    cx: number;
+    minY: number;
+    maxY: number;
+    q1Y: number;
+    q2Y: number;
+    q3Y: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface BoxYOptions {
+    cy: number;
+    minX: number;
+    maxX: number;
+    q1X: number;
+    q2X: number;
+    q3X: number;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+declare const createBoxX: (path: Path, options: BoxXOptions) => void;
+declare const createBoxY: (path: Path, options: BoxYOptions) => void;
+
+interface ShapeOptionsMap {
+    circle: CircleOptions;
+    rect: RectOptions;
+    arc: ArcOptions;
+    sector: SectorOptions;
+    line: LineOptions;
+    segmentLine: SegmentLineOptions;
+    area: AreaOptions;
+    segmentArea: SegmentAreaOptions;
+    boxX: BoxXOptions;
+    boxY: BoxYOptions;
+}
+type ShapeType = keyof ShapeOptionsMap;
+/**
+ * 统一形状工厂：按类型名分发到对应的形状生成器
+ * @param path - Path 实例（用于写入路径命令）
+ * @param type - 形状类型（circle/rect/arc/sector/line/area 等）
+ * @param options - 对应形状的配置参数
+ *
+ * @example
+ * ```ts
+ * const path = new Path();
+ * createShape(path, 'circle', { cx: 100, cy: 100, r: 50 });
+ * console.log(path.toString()); // SVG path string
+ * ```
+ */
+declare const createShape: <T extends ShapeType>(path: Path, type: T, options: ShapeOptionsMap[T]) => void;
+
+interface SymbolOptions {
+    cx: number;
+    cy: number;
+    r: number;
+}
+type SymbolCreator = (path: Path, options: SymbolOptions) => void;
+
+declare const createCircleSymbol: SymbolCreator;
+
+declare const createCrossSymbol: SymbolCreator;
+
+declare const createDiamondSymbol: SymbolCreator;
+
+declare const createSquareSymbol: SymbolCreator;
+
+declare const createStarSymbol: SymbolCreator;
+
+declare const createUpTriangleSymbol: SymbolCreator;
+declare const createDownTriangleSymbol: SymbolCreator;
+declare const createLeftTriangleSymbol: SymbolCreator;
+declare const createRightTriangleSymbol: SymbolCreator;
+declare const createTriangleSymbol: SymbolCreator;
+declare const createInvertedTriangleSymbol: SymbolCreator;
+
+declare const createWyeSymbol: SymbolCreator;
+
+declare const createHLineSymbol: SymbolCreator;
+declare const createVLineSymbol: SymbolCreator;
+
+declare const createEyeSymbol: SymbolCreator;
+declare const createClosedEyeSymbol: SymbolCreator;
+
+declare const createResetSymbol: SymbolCreator;
+
+declare const createSelectSymbol: SymbolCreator;
+
+declare const fillSymbols: string[];
+declare const createSymbol: (path: Path, symbol: string, options: SymbolOptions) => void;
+
+interface IndicatorBoxOptions {
+    anchor: 'top' | 'bottom' | 'left' | 'right';
+    anchorSize: number;
+    width: number;
+    height: number;
+}
+declare const createIndicatorBox: (path: Path, options: IndicatorBoxOptions) => void;
+
+export { type ArcOptions, type AreaOptions, type BoxXOptions, type BoxYOptions, type CircleOptions, type IndicatorBoxOptions, type LineOptions, type RectOptions, type RingOptions, type SectorOptions, type SegmentAreaOptions, type SegmentLineOptions, type SymbolCreator, type SymbolOptions, createArc, createArea, createBoxX, createBoxY, createCircle, createCircleSymbol, createClosedEyeSymbol, createCrossSymbol, createDiamondSymbol, createDownTriangleSymbol, createEyeSymbol, createHLineSymbol, createIndicatorBox, createInvertedTriangleSymbol, createLeftTriangleSymbol, createLine, createRect, createRectNormal, createRectRounded, createResetSymbol, createRightTriangleSymbol, createRing, createSector, createSectorNormal, createSectorRounded, createSegmentArea, createSegmentLine, createSelectSymbol, createShape, createSquareSymbol, createStarSymbol, createSymbol, createTriangleSymbol, createUpTriangleSymbol, createVLineSymbol, createWyeSymbol, fillSymbols };