@xiongtao.xt/tau-plugins 0.7.0 → 0.9.0

package/types/packages/whiteboard/src/utils/sketch/geometry.d.ts

@@ -0,0 +1,22 @@
+export type Vec = [number, number];
+export interface Polyline {
+    points: Vec[];
+    closed: boolean;
+}
+export declare const distance: (a: Vec, b: Vec) => number;
+export declare const clamp: (value: number, min: number, max: number) => number;
+export declare function lengthOf(points: Vec[]): number;
+export declare const polylineToD: (points: Vec[], closed?: boolean) => string;
+/** 按弧长等距重采样，首尾点保留 */
+export declare function resample(points: Vec[], step: number): Vec[];
+/**
+ * 沿法线方向的低频摆动：两段正弦按弧长叠加，相位由 random 决定。
+ * 摆动是弧长的连续函数，端点移动时线形连续变化，不会整体跳变。
+ * waveScale 缩放波长：尺寸很小的图形（火柴人等）传 <1，否则一整笔都落在半个波长内、看不出手抖。
+ */
+export declare function wobble(points: Vec[], amplitude: number, random: () => number, waveScale?: number): Vec[];
+/**
+ * SVG path d → 折线（每个子路径一条），支持 M/L/H/V/C/S/Q/T/A/Z 的绝对与相对形式。
+ * 白板里的几何轮廓与连线路径（ArrowUtil.getArrowPath）都只用到这些命令。
+ */
+export declare function flattenPath(d: string): Polyline[];

package/types/packages/whiteboard/src/utils/sketch/handText.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedSketch } from "../../types/sketch";
+/** 手绘文字容器的类名（D-107）；未启用手绘时为空串 */
+export declare const handTextClass: (sketch: ResolvedSketch) => string;

package/types/packages/whiteboard/src/utils/sketch/ink.d.ts

@@ -0,0 +1,13 @@
+import { type Vec } from "./geometry";
+export interface InkOptions {
+    /** 起笔 / 收笔渐细长度（px），0 为平头 */
+    taperStart?: number;
+    taperEnd?: number;
+    thinning?: number;
+    streamline?: number;
+}
+/**
+ * 一笔墨迹的轮廓（填充多边形）：起笔略重、行笔饱满、收笔变细，压力带极小噪声。
+ * size 为墨迹最大宽度。
+ */
+export declare function inkOutline(points: Vec[], size: number, random: () => number, options?: InkOptions): string;

package/types/packages/whiteboard/src/utils/sketch/levels.d.ts

@@ -0,0 +1,5 @@
+import type { SketchLevel } from "../../types/sketch";
+/** 各档位沿法线摆动的幅度（px） */
+export declare const WOBBLE_AMPLITUDE: Record<SketchLevel, number>;
+/** 墨迹宽度：比描边线宽略粗，补偿两端渐细后的视觉重量 */
+export declare const inkSize: (strokeWidth: number) => number;

package/types/packages/whiteboard/src/utils/sketch/random.d.ts

@@ -0,0 +1,4 @@
+/** 可复现的伪随机数（mulberry32）：同一 seed 永远得到同一序列 */
+export declare function createRandom(seed: number): () => number;
+/** 字符串 → 32 位种子（FNV-1a），用于由元素 id 派生默认笔迹 */
+export declare function hashSeed(text: string): number;

package/types/packages/whiteboard/src/utils/sketch/shape.d.ts

@@ -0,0 +1,38 @@
+import type { SketchFillStyle, SketchLevel } from "../../types/sketch";
+import { type Polyline, type Vec } from "./geometry";
+import type { SketchPath } from "./types";
+export type SketchOutline = {
+    kind: "rect";
+    cornerRadius?: number;
+} | {
+    kind: "ellipse";
+}
+/** 已缩放到元素尺寸的 path d（几何配置经 transformPath 的结果） */
+ | {
+    kind: "path";
+    paths: string[];
+};
+export interface SketchShapeInput {
+    outline: SketchOutline;
+    width: number;
+    height: number;
+    stroke?: string;
+    strokeWidth: number;
+    strokeOpacity?: number;
+    fill?: string;
+    fillOpacity?: number;
+    fillStyle?: SketchFillStyle;
+    /** 描边线型：只对圆角矩形生效；缺省实线 */
+    strokeDash?: "dashed" | "dotted";
+    /** 淡涂叠在纸上的不透明度系数，缺省 WASH_ALPHA；底色承载文字对比度时（导图节点）传 1 */
+    washAlpha?: number;
+    level: SketchLevel;
+    seed: number;
+}
+export declare function outlinePolylines(outline: SketchOutline, width: number, height: number): Polyline[];
+/** 闭合轮廓一笔绕一圈：随机起点，末尾一小段向外搭接，形成手绘的收口 */
+export declare function loopStroke(loop: Vec[], amplitude: number, random: () => number, overlapRatio?: number): Vec[];
+/** 排线间距随线宽变粗、随形状尺寸微调：大形状不稀、小形状不糊 */
+export declare const hatchGap: (strokeWidth: number, width: number, height: number) => number;
+/** 形状的手绘渲染：填充在下、轮廓墨迹在上。坐标系为元素局部坐标（0,0 ~ width,height） */
+export declare function sketchShape(input: SketchShapeInput): SketchPath[];

package/types/packages/whiteboard/src/utils/sketch/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 手绘渲染的输出单元：纯数据，由组件渲染为 <path>。
+ * - ink：墨迹（填充多边形）
+ * - wash：淡涂填充
+ * - lines：线类填充（斜线 / 交叉 / 涂鸦），深色主题下需要再退一步
+ */
+export interface SketchPath {
+    role: "ink" | "wash" | "lines";
+    d: string;
+    color: string;
+    opacity?: number;
+    /** 限制在此轮廓内（线类填充） */
+    clip?: string;
+    /** 虚线遮罩：沿中心线描粗虚线，墨迹只露出虚线段；可多段（各自节奏） */
+    dashMask?: DashMask[];
+}
+export interface DashMask {
+    d: string;
+    width: number;
+    dash: number;
+    gap: number;
+    /** stroke-dashoffset，缺省 0 */
+    offset?: number;
+}