@xiongtao.xt/tau-plugins 0.6.0 → 0.8.0

package/types/packages/whiteboard/src/extensions/standard-schema.d.ts

@@ -0,0 +1,32 @@
+export interface StandardSchemaV1<Input = unknown, Output = Input> {
+    readonly "~standard": StandardSchemaV1.Props<Input, Output>;
+}
+export declare namespace StandardSchemaV1 {
+    interface Props<Input = unknown, Output = Input> {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => Result<Output> | Promise<Result<Output>>;
+        readonly types?: Types<Input, Output> | undefined;
+    }
+    interface Types<Input = unknown, Output = Input> {
+        readonly input: Input;
+        readonly output: Output;
+    }
+    type Result<Output> = SuccessResult<Output> | FailureResult;
+    interface SuccessResult<Output> {
+        readonly value: Output;
+        readonly issues?: undefined;
+    }
+    interface FailureResult {
+        readonly issues: ReadonlyArray<Issue>;
+    }
+    interface Issue {
+        readonly message: string;
+        readonly path?: ReadonlyArray<PropertyKey | PathSegment> | undefined;
+    }
+    interface PathSegment {
+        readonly key: PropertyKey;
+    }
+    type InferInput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["input"];
+    type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
+}

package/types/packages/whiteboard/src/types/containment.d.ts

@@ -0,0 +1,3 @@
+/** 受限容器类别；元素以 joins 声明愿意进入的容器组。 */
+export declare const CONTAINER_KINDS: readonly ["layout"];
+export type ContainerKind = (typeof CONTAINER_KINDS)[number];

package/types/packages/whiteboard/src/types/element.d.ts

@@ -0,0 +1,33 @@
+import type { EntityRef } from "../../../shared/entity-ref";
+import type { ElementSketch } from "./sketch";
+import type { Point } from "./point";
+/** 白板持久化元素；不依赖 Board 或内部插件实例。 */
+export interface BoardElement {
+    id: string;
+    type: string;
+    name?: string;
+    groupId?: string;
+    children?: BoardElement[];
+    resizable?: boolean;
+    autoHeight?: boolean;
+    entityRef?: EntityRef;
+    sketch?: ElementSketch;
+    schemaVersion?: number;
+    [key: string]: any;
+}
+export interface ElementBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+export interface BoardContextMenuPayload {
+    clientX: number;
+    clientY: number;
+    viewPortPoint: Point;
+    selectedElements: BoardElement[];
+    hitElements: BoardElement[];
+    targetElements: BoardElement[];
+    hitElement?: BoardElement;
+    isHitSelected: boolean;
+}

package/types/packages/whiteboard/src/types/operation.d.ts

@@ -0,0 +1,51 @@
+import { Selection } from "./selection";
+import type { BoardElement } from "./element";
+import { ViewPort } from "./viewport";
+import { Path } from "./path";
+import { PageSketch } from "./sketch";
+export type SetNodePatch = Partial<Omit<BoardElement, "children">> & {
+    children?: never;
+};
+export type InsertNodeOperation = {
+    type: "insert_node";
+    path: Path;
+    node: BoardElement;
+};
+export type RemoveNodeOperation = {
+    type: "remove_node";
+    path: Path;
+    node: BoardElement;
+};
+export type MoveNodeOperation = {
+    type: "move_node";
+    path: Path;
+    newPath: Path;
+};
+export type SetNodeOperation = {
+    type: "set_node";
+    path: Path;
+    properties: SetNodePatch;
+    newProperties: SetNodePatch;
+};
+export type SetSelectionOperation = {
+    type: "set_selection";
+    properties: Partial<Selection>;
+    newProperties: Partial<Selection>;
+};
+export type SetViewportOperation = {
+    type: "set_viewport";
+    properties: Partial<ViewPort>;
+    newProperties: Partial<ViewPort>;
+};
+/** 页级画风（D-107），进撤销历史 */
+export type SetSketchOperation = {
+    type: "set_sketch";
+    properties: Partial<PageSketch>;
+    newProperties: Partial<PageSketch>;
+};
+export type SetMovingOperation = {
+    type: "set_moving";
+    properties: BoardElement[];
+    newProperties: BoardElement[];
+};
+export type Operation = InsertNodeOperation | RemoveNodeOperation | MoveNodeOperation | SetNodeOperation | SetViewportOperation | SetSelectionOperation | SetMovingOperation | SetSketchOperation;

package/types/packages/whiteboard/src/types/path.d.ts

@@ -0,0 +1 @@
+export type Path = number[];

package/types/packages/whiteboard/src/types/point.d.ts

@@ -0,0 +1,4 @@
+export interface Point {
+    x: number;
+    y: number;
+}

package/types/packages/whiteboard/src/types/presentation.d.ts

@@ -0,0 +1,11 @@
+export interface PresentationFrame {
+    id: string;
+    elements: string[];
+}
+export interface PresentationSequence {
+    id: string;
+    name: string;
+    frames: PresentationFrame[];
+    createTime: number;
+    updateTime: number;
+}

package/types/packages/whiteboard/src/types/schematic.d.ts

@@ -0,0 +1,44 @@
+/** 纯色，或由 CSS linear-gradient 解析出的渐变（文本卡片常用渐变底） */
+export type SchematicFill = string | {
+    angle: number;
+    stops: Array<{
+        color: string;
+        offset: number;
+    }>;
+};
+export type SchematicShape = {
+    kind: "rect";
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    r: number;
+    fill: SchematicFill;
+    fillOpacity?: number;
+    stroke?: string;
+    /** 输出像素 */
+    strokeWidth?: number;
+} | {
+    kind: "path";
+    d: string;
+    fill?: string;
+    fillOpacity?: number;
+    stroke?: string;
+    strokeOpacity?: number;
+    /** 输出像素 */
+    strokeWidth?: number;
+    /** 归一化路径（0~1）放进元素框：translate(x y) scale(w h) */
+    box?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+} | {
+    /** 箭头端点的三角：尺寸按输出像素，组件按缩放换算 */
+    kind: "arrowhead";
+    x: number;
+    y: number;
+    angle: number;
+    color: string;
+};

package/types/packages/whiteboard/src/types/selection.d.ts

@@ -0,0 +1,11 @@
+import type { BoardElement } from "./element";
+import { Point } from "./point";
+export interface SelectArea {
+    anchor: Point;
+    focus: Point;
+}
+export interface Selection {
+    selectArea: SelectArea | null;
+    selectedElements: BoardElement[];
+    [key: string]: any;
+}

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

@@ -0,0 +1,25 @@
+/** 页面画风：手绘 / 普通（D-107） */
+export type SketchMode = "sketch" | "normal";
+/** 笔触档位：工整 / 自然 / 潦草 */
+export type SketchLevel = "neat" | "natural" | "loose";
+/** 形状填充样式；普通模式下一律按实色渲染 */
+export type SketchFillStyle = "solid" | "hatch" | "cross" | "scribble";
+/** 页级画风，存在 WhiteBoardContent.data.sketch，缺省为 DEFAULT_PAGE_SKETCH */
+export interface PageSketch {
+    mode: SketchMode;
+    level: SketchLevel;
+}
+/** 元素级覆盖；未设置的字段跟随页面 */
+export interface ElementSketch {
+    mode?: SketchMode;
+    level?: SketchLevel;
+    /** 「换一笔」写入；缺省时由元素 id 派生 */
+    seed?: number;
+}
+export declare const DEFAULT_PAGE_SKETCH: PageSketch;
+/** 生效画风：页面默认值与元素覆盖合成后的结果 */
+export interface ResolvedSketch {
+    enabled: boolean;
+    level: SketchLevel;
+    seed: number;
+}

package/types/packages/whiteboard/src/types/viewport.d.ts

@@ -0,0 +1,8 @@
+export interface ViewPort {
+    minX: number;
+    minY: number;
+    width: number;
+    height: number;
+    zoom: number;
+    [key: string]: any;
+}

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;
+}