bplinejs 0.0.101-beta.10

package/lib/Geometry/Geo.js

@@ -0,0 +1,180 @@
+import { GETID } from "../ID.js";
+import Style from "../Style/index.js";
+//#region src/scripts/Geometry/Geo.ts
+/** CPU 几何及其单一版本；样式订阅只响应影响几何生成的字段。 */
+var Geo = class {
+	/** 全局几何 ID。 */
+	id = GETID();
+	/** 对象类型。 */
+	type = "Geo";
+	_version = 0;
+	_generatedVersion = -1;
+	_style;
+	_disposed = false;
+	_subscribers = /* @__PURE__ */ new Set();
+	/** 合并三角面坐标。 */
+	_geometry;
+	/** 逐顶点二维轮廓法线。 */
+	normal;
+	/** 逐顶点 UV。 */
+	uv;
+	/** 合并三角面索引。 */
+	index;
+	/** 独立 line-list 几何。 */
+	linePoints;
+	/** 顶点用途：0 实体面、0.5 边框、1 关键点。 */
+	vertexType;
+	/** 关键点中心，其他顶点填零。 */
+	position;
+	/** 边框连接倍率，其他顶点填一。 */
+	miterScale;
+	/** 宽高、圆角和实体边框宽度。 */
+	uniformData = /* @__PURE__ */ new Float32Array(4);
+	/** @param style 共享样式，默认四个分区全部关闭 */
+	constructor(style = new Style()) {
+		this._style = style;
+		style.add(this);
+	}
+	/** 当前共享样式，分区 enabled 决定生成内容。 */
+	get style() {
+		return this._style;
+	}
+	/** @param value 新样式，先解绑旧样式并使全部几何缓存失效 */
+	set style(value) {
+		if (this._disposed) throw new Error("Disposed geometry cannot be reused.");
+		if (this._style === value) return;
+		this._style.delete(this);
+		this._style = value;
+		value.add(this);
+		this.updateVersion();
+	}
+	/**
+	* 只让几何依赖的字段触发重建，颜色和透明度不影响顶点。
+	* @param change 样式通知
+	*/
+	onStyleChange(change) {
+		if (this._disposed || change.source !== this._style) return;
+		if (change.field === "enabled" || change.area === "join" && this.type === "Poly2D" || change.area === "edge" && [
+			"width",
+			"borderAlign",
+			"uvRepeat"
+		].includes(change.field) || change.area === "points" && [
+			"vertices",
+			"midpoints",
+			"radius",
+			"segments",
+			"minPointsLength",
+			"minEdgePointsLength"
+		].includes(change.field)) this.updateVersion();
+	}
+	/** 最终停止使用时解绑 Style；不等于从 Scene 移除，不销毁 Render 缓存。 */
+	dispose() {
+		this._style.delete(this);
+		this._subscribers.clear();
+		this._disposed = true;
+	}
+	/**
+	* 关联使用当前几何的消费者，重复关联不会重复通知。
+	* @param subscriber Mesh 或其他几何消费者
+	*/
+	add(subscriber) {
+		if (this._disposed) throw new Error("Disposed geometry cannot be reused.");
+		this._subscribers.add(subscriber);
+	}
+	/**
+	* 解绑消费者，不销毁共享几何或 GPU 缓存。
+	* @param subscriber 需要解绑的消费者
+	*/
+	delete(subscriber) {
+		this._subscribers.delete(subscriber);
+	}
+	/**
+	* 获取合并三角面的二维顶点数组。
+	* @returns 顶点数组，未生成三角面时为 undefined
+	*/
+	get geometry() {
+		return this._geometry;
+	}
+	/**
+	* 替换合并三角面顶点数组并通知 GPU 缓存更新。
+	* 已生成的 CPU 数据直接提交；尚未生成的参数变化仍由 ensureGeometry 处理。
+	* @param geometry 新顶点数组
+	*/
+	set geometry(geometry) {
+		if (this._geometry === geometry) return;
+		const generatedVersion = this._generatedVersion;
+		const previousVersion = this._version;
+		this._geometry = geometry;
+		this.updateVersion();
+		if (generatedVersion === previousVersion) this._generatedVersion = this._version;
+	}
+	/**
+	* 按实体面、宽边框、关键点顺序合并全部三角面并补齐顶点属性。
+	* 索引按顶点偏移重新定位，顶点数量超过 Uint16 范围时自动升级位宽。
+	* @param parts 本次启用的几何分区
+	* @returns 无返回值
+	*/
+	mergeGeometry(parts) {
+		const vertexCount = parts.reduce((sum, part) => sum + part.data.geometry.length / 2, 0);
+		const indexCount = parts.reduce((sum, part) => sum + part.data.index.length, 0);
+		if (indexCount === 0) {
+			this._geometry = void 0;
+			this.normal = void 0;
+			this.uv = void 0;
+			this.index = void 0;
+			this.vertexType = void 0;
+			this.position = void 0;
+			this.miterScale = void 0;
+			return;
+		}
+		this._geometry = new Float32Array(vertexCount * 2);
+		this.normal = new Float32Array(vertexCount * 2);
+		this.uv = new Float32Array(vertexCount * 2);
+		this.position = new Float32Array(vertexCount * 2);
+		this.vertexType = new Float32Array(vertexCount);
+		this.miterScale = new Float32Array(vertexCount).fill(1);
+		this.index = vertexCount > 65536 ? new Uint32Array(indexCount) : new Uint16Array(indexCount);
+		let vertexOffset = 0;
+		let indexOffset = 0;
+		for (const part of parts) {
+			const data = part.data;
+			const count = data.geometry.length / 2;
+			this._geometry.set(data.geometry, vertexOffset * 2);
+			this.normal.set(data.normal, vertexOffset * 2);
+			this.uv.set(data.uv, vertexOffset * 2);
+			this.vertexType.fill(part.vertexType, vertexOffset, vertexOffset + count);
+			if (data.position !== void 0) this.position.set(data.position, vertexOffset * 2);
+			if (data.miterScale !== void 0) this.miterScale.set(data.miterScale, vertexOffset);
+			for (const index of data.index) {
+				this.index[indexOffset] = index + vertexOffset;
+				indexOffset += 1;
+			}
+			vertexOffset += count;
+		}
+	}
+	/** 当前几何版本。 */
+	get version() {
+		return this._version;
+	}
+	/** 通知 CPU 生成器及每个 Render 更新缓存。 */
+	updateVersion() {
+		this._version++;
+		for (const subscriber of [...this._subscribers]) subscriber.onGeometryChange(this);
+	}
+	/** 参数变化后延迟生成，一帧内多次改值只生成一次。 */
+	ensureGeometry() {
+		if (this._disposed) throw new Error("Disposed geometry cannot be rendered.");
+		if (this._generatedVersion !== this._version) this.updateGeometry();
+		return this;
+	}
+	/** 提交生成的数据；手动调用也会递增版本，通知每个 Render。 */
+	updateGeometry() {
+		this.updateVersion();
+		this._generatedVersion = this._version;
+		return this;
+	}
+};
+//#endregion
+export { Geo as default };
+
+//# sourceMappingURL=Geo.js.map

package/lib/Geometry/Geo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Geo.js","names":[],"sources":["../../src/scripts/Geometry/Geo.ts"],"sourcesContent":["import { GETID } from \"../ID\";\nimport Style from \"../Style\";\nimport type { StyleChange, StyleSubscriber } from \"../Style\";\n\n/** 边框对齐类型沿用 Style 定义。 */\nimport type { BorderAlign } from \"../Style\";\ninterface GeoBuffersLike {\n    vertex?: number;\n    normal?: number;\n    uv?: number;\n    index?: number;\n}\n/** 单个几何分区的顶点属性。 */\ninterface GeoPartDataLike {\n    geometry: Float32Array;\n    normal: Float32Array;\n    uv: Float32Array;\n    index: Uint16Array | Uint32Array;\n    /** 点型逐顶点中心坐标，长度与 geometry 相同。 */\n    position?: Float32Array;\n    /** 每个顶点的用途：0 为实体面，0.5 为宽边框，1 为关键点。 */\n    vertexType?: Float32Array;\n    miterScale?: Float32Array;\n}\n\n\n/** 几何消费者；通知只标记后续工作，不在回调中生成几何或操作 GPU。 */\ninterface GeometrySubscriber {\n    onGeometryChange(geometry: GeoData): void;\n}\n\ninterface GeoData extends StyleSubscriber {\n    readonly id: number;\n    readonly type: string;\n    readonly version: number;\n    style: Style;\n    geometry: Float32Array | undefined;\n    normal: Float32Array | undefined;\n    uv: Float32Array | undefined;\n    index: Uint16Array | Uint32Array | undefined;\n    linePoints: GeoPartDataLike | undefined;\n    vertexType: Float32Array | undefined;\n    position: Float32Array | undefined;\n    miterScale: Float32Array | undefined;\n    readonly uniformData: Float32Array<ArrayBuffer>;\n    add(subscriber: GeometrySubscriber): void;\n    delete(subscriber: GeometrySubscriber): void;\n    updateVersion(): void;\n    ensureGeometry(): this;\n    updateGeometry(): this;\n    dispose(): void;\n}\n\n/** CPU 几何及其单一版本；样式订阅只响应影响几何生成的字段。 */\nclass Geo implements GeoData {\n    /** 全局几何 ID。 */\n    public readonly id: number = GETID();\n    /** 对象类型。 */\n    public readonly type: string = \"Geo\";\n    private _version: number = 0;\n    private _generatedVersion: number = -1;\n    private _style: Style;\n    private _disposed: boolean = false;\n    private readonly _subscribers = new Set<GeometrySubscriber>();\n    /** 合并三角面坐标。 */\n    protected _geometry: Float32Array | undefined;\n    /** 逐顶点二维轮廓法线。 */\n    public normal: Float32Array | undefined;\n    /** 逐顶点 UV。 */\n    public uv: Float32Array | undefined;\n    /** 合并三角面索引。 */\n    public index: Uint16Array | Uint32Array | undefined;\n    /** 独立 line-list 几何。 */\n    public linePoints: GeoPartDataLike | undefined;\n    /** 顶点用途：0 实体面、0.5 边框、1 关键点。 */\n    public vertexType: Float32Array | undefined;\n    /** 关键点中心，其他顶点填零。 */\n    public position: Float32Array | undefined;\n    /** 边框连接倍率，其他顶点填一。 */\n    public miterScale: Float32Array | undefined;\n    /** 宽高、圆角和实体边框宽度。 */\n    public readonly uniformData: Float32Array<ArrayBuffer> = new Float32Array(4);\n\n    /** @param style 共享样式，默认四个分区全部关闭 */\n    public constructor(style: Style = new Style()) {\n        this._style = style;\n        style.add(this);\n    }\n    /** 当前共享样式，分区 enabled 决定生成内容。 */\n    public get style(): Style { return this._style; }\n    /** @param value 新样式，先解绑旧样式并使全部几何缓存失效 */\n    public set style(value: Style) {\n        if (this._disposed) throw new Error(\"Disposed geometry cannot be reused.\");\n        if (this._style === value) return;\n        this._style.delete(this);\n        this._style = value;\n        value.add(this);\n        this.updateVersion();\n    }\n    /**\n     * 只让几何依赖的字段触发重建，颜色和透明度不影响顶点。\n     * @param change 样式通知\n     */\n    public onStyleChange(change: StyleChange): void {\n        if (this._disposed || change.source !== this._style) return;\n        if (change.field === \"enabled\"\n            || (change.area === \"join\" && this.type === \"Poly2D\")\n            || (change.area === \"edge\" && [\"width\", \"borderAlign\", \"uvRepeat\"].includes(change.field))\n            || (change.area === \"points\" && [\"vertices\", \"midpoints\", \"radius\", \"segments\", \"minPointsLength\", \"minEdgePointsLength\"].includes(change.field))) {\n            this.updateVersion();\n        }\n    }\n    /** 最终停止使用时解绑 Style；不等于从 Scene 移除，不销毁 Render 缓存。 */\n    public dispose(): void {\n        this._style.delete(this);\n        this._subscribers.clear();\n        this._disposed = true;\n    }\n\n    /**\n     * 关联使用当前几何的消费者，重复关联不会重复通知。\n     * @param subscriber Mesh 或其他几何消费者\n     */\n    public add(subscriber: GeometrySubscriber): void {\n        if (this._disposed) throw new Error(\"Disposed geometry cannot be reused.\");\n        this._subscribers.add(subscriber);\n    }\n\n    /**\n     * 解绑消费者，不销毁共享几何或 GPU 缓存。\n     * @param subscriber 需要解绑的消费者\n     */\n    public delete(subscriber: GeometrySubscriber): void {\n        this._subscribers.delete(subscriber);\n    }\n\n    /**\n     * 获取合并三角面的二维顶点数组。\n     * @returns 顶点数组，未生成三角面时为 undefined\n     */\n    public get geometry(): Float32Array | undefined {\n        return this._geometry;\n    }\n\n    /**\n     * 替换合并三角面顶点数组并通知 GPU 缓存更新。\n     * 已生成的 CPU 数据直接提交；尚未生成的参数变化仍由 ensureGeometry 处理。\n     * @param geometry 新顶点数组\n     */\n    public set geometry(geometry: Float32Array | undefined) {\n        if (this._geometry === geometry) {\n            return;\n        }\n\n        const generatedVersion: number = this._generatedVersion;\n        const previousVersion: number = this._version;\n        this._geometry = geometry;\n        this.updateVersion();\n        if (generatedVersion === previousVersion) {\n            this._generatedVersion = this._version;\n        }\n    }\n\n\n    /**\n     * 按实体面、宽边框、关键点顺序合并全部三角面并补齐顶点属性。\n     * 索引按顶点偏移重新定位，顶点数量超过 Uint16 范围时自动升级位宽。\n     * @param parts 本次启用的几何分区\n     * @returns 无返回值\n     */\n    protected mergeGeometry(parts: { data: GeoPartDataLike; vertexType: number }[]): void {\n        const vertexCount: number = parts.reduce((sum, part): number => sum + part.data.geometry.length / 2, 0);\n        const indexCount: number = parts.reduce((sum, part): number => sum + part.data.index.length, 0);\n        if (indexCount === 0) {\n            this._geometry = undefined;\n            this.normal = undefined;\n            this.uv = undefined;\n            this.index = undefined;\n            this.vertexType = undefined;\n            this.position = undefined;\n            this.miterScale = undefined;\n            return;\n        }\n        this._geometry = new Float32Array(vertexCount * 2);\n        this.normal = new Float32Array(vertexCount * 2);\n        this.uv = new Float32Array(vertexCount * 2);\n        this.position = new Float32Array(vertexCount * 2);\n        this.vertexType = new Float32Array(vertexCount);\n        this.miterScale = new Float32Array(vertexCount).fill(1);\n        this.index = vertexCount > 65536 ? new Uint32Array(indexCount) : new Uint16Array(indexCount);\n\n        let vertexOffset: number = 0;\n        let indexOffset: number = 0;\n        for (const part of parts) {\n            const data = part.data;\n            const count: number = data.geometry.length / 2;\n            this._geometry.set(data.geometry, vertexOffset * 2);\n            this.normal.set(data.normal, vertexOffset * 2);\n            this.uv.set(data.uv, vertexOffset * 2);\n            this.vertexType.fill(part.vertexType, vertexOffset, vertexOffset + count);\n            if (data.position !== undefined) this.position.set(data.position, vertexOffset * 2);\n            if (data.miterScale !== undefined) this.miterScale.set(data.miterScale, vertexOffset);\n            for (const index of data.index) {\n                this.index[indexOffset] = index + vertexOffset;\n                indexOffset += 1;\n            }\n            vertexOffset += count;\n        }\n    }\n\n    /** 当前几何版本。 */\n    public get version(): number { return this._version; }\n    /** 通知 CPU 生成器及每个 Render 更新缓存。 */\n    public updateVersion(): void {\n        this._version++;\n        for (const subscriber of [...this._subscribers]) subscriber.onGeometryChange(this);\n    }\n    /** 参数变化后延迟生成，一帧内多次改值只生成一次。 */\n    public ensureGeometry(): this {\n        if (this._disposed) throw new Error(\"Disposed geometry cannot be rendered.\");\n        if (this._generatedVersion !== this._version) this.updateGeometry();\n        return this;\n    }\n    /** 提交生成的数据；手动调用也会递增版本，通知每个 Render。 */\n    public updateGeometry(): this {\n        this.updateVersion();\n        this._generatedVersion = this._version;\n        return this;\n    }\n}\nexport default Geo;\nexport type { BorderAlign, GeoBuffersLike, GeoData, GeoPartDataLike, GeometrySubscriber };\n"],"mappings":"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"}

package/lib/Geometry/Poly2D.d.ts

@@ -0,0 +1,53 @@
+import Geo from "./Geo";
+import type { GeoData } from "./Geo";
+import type Style from "../Style";
+interface Poly2DOptions {
+    /** 默认闭合；开放路径不能启用 style.solid.enabled。 */
+    closed?: boolean;
+}
+interface Poly2DLike extends GeoData {
+    points: Float32Array;
+    closed: boolean;
+    readonly width: number;
+    readonly height: number;
+    readonly perimeter: number;
+}
+/** 单轮廓多边形/开放折线，使用通用三角面填充和实体边框，不使用矩形 SDF。 */
+declare class Poly2D extends Geo implements Poly2DLike {
+    /** 对象及管线选择类型。 */
+    readonly type: string;
+    private _points;
+    private _closed;
+    private _width;
+    private _height;
+    private _perimeter;
+    /**
+     * 创建多边形，不平移输入坐标。
+     * @param points 有序平面坐标 [x,y,...]，默认空数组；点数不足暂不生成，输入会复制
+     * @param style 可省略或传 null，此时创建全部分区关闭的 Style
+     * @param options 可选闭合设置，默认 true；开放路径使用 closed:false
+     */
+    constructor(points?: Float32Array, style?: Style | null, options?: Poly2DOptions);
+    /** 当前自有节点数组；直接改元素后须调用 updateVersion() 或 updateGeometry()。 */
+    get points(): Float32Array<ArrayBuffer>;
+    /** @param value 新坐标，复制并触发下一帧重建 */
+    set points(value: Float32Array);
+    /** 是否连接末点和首点。 */
+    get closed(): boolean;
+    /** @param value 闭合开关；开放时需要关闭 solid */
+    set closed(value: boolean);
+    /** 当前轮廓包围盒宽度。 */
+    get width(): number;
+    /** 当前轮廓包围盒高度。 */
+    get height(): number;
+    /** 中心线长度；开放路径不计算末点到首点，圆接不增加原始路径长度。 */
+    get perimeter(): number;
+    /**
+     * 按当前 Style 全量生成填充、实体边框、辅助点和 line-list，并提交单一版本。
+     * join 只改变边框连接，solid 和辅助点仍使用原始节点。
+     * @returns 当前几何体
+     */
+    updateGeometry(): this;
+}
+export default Poly2D;
+export type { Poly2DLike, Poly2DOptions };

package/lib/Geometry/Poly2D.js

@@ -0,0 +1,133 @@
+import Geo from "./Geo.js";
+import Poly from "bpmatrixjs/Geometry/Poly";
+//#region src/scripts/Geometry/Poly2D.ts
+/**
+* 验证并复制 [x,y,x,y,...] 输入，防止调用方修改原数组后静默改变几何。
+* @param points 有序单轮廓坐标，只接收 Float32Array
+* @returns 自有数组
+*/
+var CopyPoints = (points) => {
+	if (!(points instanceof Float32Array)) throw new TypeError("Poly2D points must be a Float32Array.");
+	if (points.length % 2 !== 0) throw new RangeError("Poly2D needs complete x/y pairs.");
+	for (const value of points) if (!Number.isFinite(value)) throw new RangeError("Poly2D coordinates must be finite.");
+	return new Float32Array(points);
+};
+/** 单轮廓多边形/开放折线，使用通用三角面填充和实体边框，不使用矩形 SDF。 */
+var Poly2D = class extends Geo {
+	/** 对象及管线选择类型。 */
+	type = "Poly2D";
+	_points;
+	_closed;
+	_width = 0;
+	_height = 0;
+	_perimeter = 0;
+	/**
+	* 创建多边形，不平移输入坐标。
+	* @param points 有序平面坐标 [x,y,...]，默认空数组；点数不足暂不生成，输入会复制
+	* @param style 可省略或传 null，此时创建全部分区关闭的 Style
+	* @param options 可选闭合设置，默认 true；开放路径使用 closed:false
+	*/
+	constructor(points = /* @__PURE__ */ new Float32Array(0), style, options = {}) {
+		const copied = CopyPoints(points);
+		super(style ?? void 0);
+		this._points = copied;
+		this._closed = options.closed ?? true;
+		try {
+			this.updateGeometry();
+		} catch (error) {
+			this.dispose();
+			throw error;
+		}
+	}
+	/** 当前自有节点数组；直接改元素后须调用 updateVersion() 或 updateGeometry()。 */
+	get points() {
+		return this._points;
+	}
+	/** @param value 新坐标，复制并触发下一帧重建 */
+	set points(value) {
+		const copied = CopyPoints(value);
+		this._points = copied;
+		this.updateVersion();
+	}
+	/** 是否连接末点和首点。 */
+	get closed() {
+		return this._closed;
+	}
+	/** @param value 闭合开关；开放时需要关闭 solid */
+	set closed(value) {
+		if (this._closed === value) return;
+		if (!value && this.style.solid.enabled) throw new Error("Disable solid before opening Poly2D.");
+		this._closed = value;
+		this.updateVersion();
+	}
+	/** 当前轮廓包围盒宽度。 */
+	get width() {
+		this.ensureGeometry();
+		return this._width;
+	}
+	/** 当前轮廓包围盒高度。 */
+	get height() {
+		this.ensureGeometry();
+		return this._height;
+	}
+	/** 中心线长度；开放路径不计算末点到首点，圆接不增加原始路径长度。 */
+	get perimeter() {
+		this.ensureGeometry();
+		return this._perimeter;
+	}
+	/**
+	* 按当前 Style 全量生成填充、实体边框、辅助点和 line-list，并提交单一版本。
+	* join 只改变边框连接，solid 和辅助点仍使用原始节点。
+	* @returns 当前几何体
+	*/
+	updateGeometry() {
+		const join = this.style.join;
+		const nodes = [];
+		for (let i = 0; i < this._points.length; i += 2) nodes.push({
+			x: this._points[i],
+			y: this._points[i + 1],
+			round: join.type !== "miter",
+			segments: join.type === "bevel" ? 1 : join.seg
+		});
+		const poly = new Poly(nodes, {
+			closed: this._closed,
+			solid: this.style.solid.enabled
+		});
+		const geometry = this.style.solid.enabled ? poly.data : void 0;
+		const line = this.style.wireframe.enabled ? poly.createLineGeometry() : void 0;
+		const edge = this.style.edge;
+		const border = edge.enabled && edge.width > 0 ? poly.createBorderGeometry(edge.width, edge.uvRepeat, edge.borderAlign) : void 0;
+		const point = this.style.points;
+		const points = point.enabled && (point.vertices || point.midpoints) ? poly.createPointGeometry(point.radius, point.segments, point.vertices, point.midpoints, point.minPointsLength, point.minEdgePointsLength) : void 0;
+		const parts = [];
+		if (geometry !== void 0) parts.push({
+			data: geometry,
+			vertexType: 0
+		});
+		if (border !== void 0) parts.push({
+			data: border,
+			vertexType: .5
+		});
+		if (points !== void 0) parts.push({
+			data: points,
+			vertexType: 1
+		});
+		this.mergeGeometry(parts);
+		this.linePoints = line;
+		this._width = poly.width;
+		this._height = poly.height;
+		this._perimeter = poly.getPerimeter();
+		this.uniformData.set([
+			poly.width,
+			poly.height,
+			0,
+			edge.width
+		]);
+		super.updateGeometry();
+		return this;
+	}
+};
+//#endregion
+export { Poly2D as default };
+
+//# sourceMappingURL=Poly2D.js.map

package/lib/Geometry/Poly2D.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Poly2D.js","names":[],"sources":["../../src/scripts/Geometry/Poly2D.ts"],"sourcesContent":["import Poly from \"bpmatrixjs/Geometry/Poly\";\nimport type { PolyNode } from \"bpmatrixjs/Geometry/Poly\";\nimport Geo from \"./Geo\";\nimport type { GeoData, GeoPartDataLike } from \"./Geo\";\nimport type Style from \"../Style\";\n\ninterface Poly2DOptions {\n    /** 默认闭合；开放路径不能启用 style.solid.enabled。 */\n    closed?: boolean;\n}\n\ninterface Poly2DLike extends GeoData {\n    points: Float32Array;\n    closed: boolean;\n    readonly width: number;\n    readonly height: number;\n    readonly perimeter: number;\n}\n\n/**\n * 验证并复制 [x,y,x,y,...] 输入，防止调用方修改原数组后静默改变几何。\n * @param points 有序单轮廓坐标，只接收 Float32Array\n * @returns 自有数组\n */\nconst CopyPoints = (points: Float32Array): Float32Array<ArrayBuffer> => {\n    if (!(points instanceof Float32Array)) throw new TypeError(\"Poly2D points must be a Float32Array.\");\n    if (points.length % 2 !== 0) throw new RangeError(\"Poly2D needs complete x/y pairs.\");\n    for (const value of points) if (!Number.isFinite(value)) throw new RangeError(\"Poly2D coordinates must be finite.\");\n    return new Float32Array(points);\n};\n\n/** 单轮廓多边形/开放折线，使用通用三角面填充和实体边框，不使用矩形 SDF。 */\nclass Poly2D extends Geo implements Poly2DLike {\n    /** 对象及管线选择类型。 */\n    public readonly type: string = \"Poly2D\";\n    private _points: Float32Array<ArrayBuffer>;\n    private _closed: boolean;\n    private _width: number = 0;\n    private _height: number = 0;\n    private _perimeter: number = 0;\n\n    /**\n     * 创建多边形，不平移输入坐标。\n     * @param points 有序平面坐标 [x,y,...]，默认空数组；点数不足暂不生成，输入会复制\n     * @param style 可省略或传 null，此时创建全部分区关闭的 Style\n     * @param options 可选闭合设置，默认 true；开放路径使用 closed:false\n     */\n    public constructor(points: Float32Array = new Float32Array(0), style?: Style | null, options: Poly2DOptions = {}) {\n        const copied = CopyPoints(points);\n        super(style ?? undefined);\n        this._points = copied;\n        this._closed = options.closed ?? true;\n        try {\n            this.updateGeometry();\n        } catch (error) {\n            this.dispose();\n            throw error;\n        }\n    }\n\n    /** 当前自有节点数组；直接改元素后须调用 updateVersion() 或 updateGeometry()。 */\n    public get points(): Float32Array<ArrayBuffer> { return this._points; }\n    /** @param value 新坐标，复制并触发下一帧重建 */\n    public set points(value: Float32Array) {\n        const copied = CopyPoints(value);\n        this._points = copied;\n        this.updateVersion();\n    }\n    /** 是否连接末点和首点。 */\n    public get closed(): boolean { return this._closed; }\n    /** @param value 闭合开关；开放时需要关闭 solid */\n    public set closed(value: boolean) {\n        if (this._closed === value) return;\n        if (!value && this.style.solid.enabled) throw new Error(\"Disable solid before opening Poly2D.\");\n        this._closed = value;\n        this.updateVersion();\n    }\n    /** 当前轮廓包围盒宽度。 */\n    public get width(): number { this.ensureGeometry(); return this._width; }\n    /** 当前轮廓包围盒高度。 */\n    public get height(): number { this.ensureGeometry(); return this._height; }\n    /** 中心线长度；开放路径不计算末点到首点，圆接不增加原始路径长度。 */\n    public get perimeter(): number { this.ensureGeometry(); return this._perimeter; }\n\n    /**\n     * 按当前 Style 全量生成填充、实体边框、辅助点和 line-list，并提交单一版本。\n     * join 只改变边框连接，solid 和辅助点仍使用原始节点。\n     * @returns 当前几何体\n     */\n    public updateGeometry(): this {\n        const join = this.style.join;\n        const nodes: PolyNode[] = [];\n        for (let i = 0; i < this._points.length; i += 2) {\n            nodes.push({ x: this._points[i], y: this._points[i + 1], round: join.type !== \"miter\", segments: join.type === \"bevel\" ? 1 : join.seg });\n        }\n        const poly = new Poly(nodes, { closed: this._closed, solid: this.style.solid.enabled });\n        const geometry = this.style.solid.enabled ? poly.data : undefined;\n        const line = this.style.wireframe.enabled ? poly.createLineGeometry() : undefined;\n        const edge = this.style.edge;\n        const border = edge.enabled && edge.width > 0 ? poly.createBorderGeometry(edge.width, edge.uvRepeat, edge.borderAlign) : undefined;\n        const point = this.style.points;\n        const points = point.enabled && (point.vertices || point.midpoints)\n            ? poly.createPointGeometry(point.radius, point.segments, point.vertices, point.midpoints, point.minPointsLength, point.minEdgePointsLength)\n            : undefined;\n        const parts: { data: GeoPartDataLike; vertexType: number }[] = [];\n        if (geometry !== undefined) parts.push({ data: geometry, vertexType: 0 });\n        if (border !== undefined) parts.push({ data: border, vertexType: 0.5 });\n        if (points !== undefined) parts.push({ data: points, vertexType: 1 });\n        this.mergeGeometry(parts);\n        this.linePoints = line;\n        this._width = poly.width;\n        this._height = poly.height;\n        this._perimeter = poly.getPerimeter();\n        // 沿用四个 f32 的几何 Uniform，第三项不用于多边形，UV 已由生成器给出。\n        this.uniformData.set([poly.width, poly.height, 0, edge.width]);\n        super.updateGeometry();\n        return this;\n    }\n}\n\nexport default Poly2D;\nexport type { Poly2DLike, Poly2DOptions };\n"],"mappings":"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"}

package/lib/Geometry/Rect2d.d.ts

@@ -0,0 +1,89 @@
+import Geo from "./Geo";
+import type Style from "../Style";
+import type { GeoData } from "./Geo";
+/**
+ * 矩形初始化选项；所有生成开关均默认关闭，辅助点型独立于面与边框。
+ */
+interface Rect2dOptions {
+    /** 矩形宽度，默认 1，允许为 0。 */
+    width?: number;
+    /** 矩形高度，默认 1，允许为 0。 */
+    height?: number;
+    /** 圆角半径，默认 1，生成时限制到半宽和半高的较小值。 */
+    radius?: number;
+    /** 共享样式；未传入时全部生成分区关闭。 */
+    style?: Style;
+}
+interface Rect2dLike extends GeoData {
+    width: number;
+    height: number;
+    radius: number;
+    readonly perimeter: number;
+}
+declare class Rect2d extends Geo implements Rect2dLike {
+    /**
+     * 对象类型
+     */
+    readonly type: string;
+    /**
+     * 矩形宽度。
+     */
+    private _width;
+    /**
+     * 矩形高度。
+     */
+    private _height;
+    /**
+     * 矩形圆角半径。
+     */
+    private _radius;
+    /**
+     * 创建矩形几何体并生成首个 CPU 数据版本。
+     * @param options 宽高、圆角、几何生成开关与辅助点型参数
+     */
+    constructor(options?: Rect2dOptions);
+    /**
+     * 重新生成矩形三角面、UV、索引与 Shader 参数。
+     * 完成后提交 CPU 数据版本，通知所有 Render 更新缓存。
+     * @returns 当前矩形几何体
+     */
+    updateGeometry(): this;
+    /**
+     * 设置矩形宽度并递增几何体版本。
+     * @param width 矩形宽度
+     */
+    set width(width: number);
+    /**
+     * 获取矩形宽度。
+     * @returns 矩形宽度
+     */
+    get width(): number;
+    /**
+     * 设置矩形高度并递增几何体版本。
+     * @param height 矩形高度
+     */
+    set height(height: number);
+    /**
+     * 获取矩形高度。
+     * @returns 矩形高度
+     */
+    get height(): number;
+    /**
+     * 设置圆角半径并递增几何体版本。
+     * @param radius 圆角半径
+     */
+    set radius(radius: number);
+    /**
+     * 获取圆角半径。
+     * @returns 圆角半径
+     */
+    get radius(): number;
+    /**
+     * 获取矩形实际离散轮廓的只读周长。
+     * 结果使用与矩形几何体相同的圆角限制和分段规则。
+     * @returns 矩形轮廓周长
+     */
+    get perimeter(): number;
+}
+export default Rect2d;
+export type { Rect2dLike, Rect2dOptions };

package/lib/Geometry/Rect2d.js

@@ -0,0 +1,128 @@
+import Geo from "./Geo.js";
+import { CreateRectBorderGeometry, CreateRectGeometry, CreateRectLineGeometry, CreateRectPointGeometry, GetRectPerimeter } from "bpmatrixjs/Geometry/Rect";
+//#region src/scripts/Geometry/Rect2d.ts
+var Rect2d = class extends Geo {
+	/**
+	* 对象类型
+	*/
+	type = "Rect2d";
+	/**
+	* 矩形宽度。
+	*/
+	_width;
+	/**
+	* 矩形高度。
+	*/
+	_height;
+	/**
+	* 矩形圆角半径。
+	*/
+	_radius;
+	/**
+	* 创建矩形几何体并生成首个 CPU 数据版本。
+	* @param options 宽高、圆角、几何生成开关与辅助点型参数
+	*/
+	constructor(options = {}) {
+		super(options.style);
+		this._width = options.width ?? 1;
+		this._height = options.height ?? 1;
+		this._radius = options.radius ?? 1;
+		this.updateGeometry();
+	}
+	/**
+	* 重新生成矩形三角面、UV、索引与 Shader 参数。
+	* 完成后提交 CPU 数据版本，通知所有 Render 更新缓存。
+	* @returns 当前矩形几何体
+	*/
+	updateGeometry() {
+		this._width = Number.isFinite(this._width) ? Math.max(0, this._width) : 0;
+		this._height = Number.isFinite(this._height) ? Math.max(0, this._height) : 0;
+		this._radius = Number.isFinite(this._radius) ? Math.max(0, Math.min(this._radius, this._width * .5, this._height * .5)) : 0;
+		const geometry = this.style.solid.enabled ? CreateRectGeometry(this._width, this._height, this._radius) : void 0;
+		this.linePoints = this.style.wireframe.enabled ? CreateRectLineGeometry(this._width, this._height, this._radius, 1) : void 0;
+		const border = this.style.edge.enabled && this.style.edge.width > 0 ? CreateRectBorderGeometry(this._width, this._height, this._radius, this.style.edge.width, this.style.edge.uvRepeat, this.style.edge.borderAlign) : void 0;
+		const points = this.style.points.enabled && (this.style.points.vertices || this.style.points.midpoints) ? CreateRectPointGeometry(this._width, this._height, this._radius, this.style.points.radius, this.style.points.segments, this.style.points.vertices, this.style.points.midpoints, this.style.points.minPointsLength, this.style.points.minEdgePointsLength) : void 0;
+		const parts = [];
+		if (geometry !== void 0) parts.push({
+			data: geometry,
+			vertexType: 0
+		});
+		if (border !== void 0) parts.push({
+			data: border,
+			vertexType: .5
+		});
+		if (points !== void 0) parts.push({
+			data: points,
+			vertexType: 1
+		});
+		this.mergeGeometry(parts);
+		this.uniformData.set([
+			this._width,
+			this._height,
+			this._radius,
+			this.style.edge.width
+		]);
+		super.updateGeometry();
+		return this;
+	}
+	/**
+	* 设置矩形宽度并递增几何体版本。
+	* @param width 矩形宽度
+	*/
+	set width(width) {
+		if (this._width === width) return;
+		this._width = width;
+		this.updateVersion();
+	}
+	/**
+	* 获取矩形宽度。
+	* @returns 矩形宽度
+	*/
+	get width() {
+		return this._width;
+	}
+	/**
+	* 设置矩形高度并递增几何体版本。
+	* @param height 矩形高度
+	*/
+	set height(height) {
+		if (this._height === height) return;
+		this._height = height;
+		this.updateVersion();
+	}
+	/**
+	* 获取矩形高度。
+	* @returns 矩形高度
+	*/
+	get height() {
+		return this._height;
+	}
+	/**
+	* 设置圆角半径并递增几何体版本。
+	* @param radius 圆角半径
+	*/
+	set radius(radius) {
+		if (this._radius === radius) return;
+		this._radius = radius;
+		this.updateVersion();
+	}
+	/**
+	* 获取圆角半径。
+	* @returns 圆角半径
+	*/
+	get radius() {
+		return this._radius;
+	}
+	/**
+	* 获取矩形实际离散轮廓的只读周长。
+	* 结果使用与矩形几何体相同的圆角限制和分段规则。
+	* @returns 矩形轮廓周长
+	*/
+	get perimeter() {
+		return GetRectPerimeter(this._width, this._height, this._radius);
+	}
+};
+//#endregion
+export { Rect2d as default };
+
+//# sourceMappingURL=Rect2d.js.map

package/lib/Geometry/Rect2d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rect2d.js","names":[],"sources":["../../src/scripts/Geometry/Rect2d.ts"],"sourcesContent":["\nimport {\n    CreateRectBorderGeometry,\n    CreateRectGeometry,\n    CreateRectLineGeometry,\n    CreateRectPointGeometry,\n    GetRectPerimeter,\n} from \"bpmatrixjs/Geometry/Rect\";\nimport Geo from \"./Geo\";\nimport type Style from \"../Style\";\nimport type { GeoData, GeoPartDataLike } from \"./Geo\";\n\n/**\n * 矩形初始化选项；所有生成开关均默认关闭，辅助点型独立于面与边框。\n */\ninterface Rect2dOptions {\n    /** 矩形宽度，默认 1，允许为 0。 */\n    width?: number;\n    /** 矩形高度，默认 1，允许为 0。 */\n    height?: number;\n    /** 圆角半径，默认 1，生成时限制到半宽和半高的较小值。 */\n    radius?: number;\n    /** 共享样式；未传入时全部生成分区关闭。 */\n    style?: Style;\n}\n\ninterface Rect2dLike extends GeoData {\n    width: number;\n    height: number;\n    radius: number;\n    readonly perimeter: number;\n}\n\n\nclass Rect2d extends Geo implements Rect2dLike {\n    /**\n     * 对象类型\n     */\n    public readonly type: string = \"Rect2d\";\n\n    /**\n     * 矩形宽度。\n     */\n    private _width: number;\n\n    /**\n     * 矩形高度。\n     */\n    private _height: number;\n\n    /**\n     * 矩形圆角半径。\n     */\n    private _radius: number;\n\n    /**\n     * 创建矩形几何体并生成首个 CPU 数据版本。\n     * @param options 宽高、圆角、几何生成开关与辅助点型参数\n     */\n    public constructor(options: Rect2dOptions = {}) {\n        super(options.style);\n        this._width = options.width ?? 1;\n        this._height = options.height ?? 1;\n        this._radius = options.radius ?? 1;\n        this.updateGeometry();\n    }\n\n    /**\n     * 重新生成矩形三角面、UV、索引与 Shader 参数。\n     * 完成后提交 CPU 数据版本，通知所有 Render 更新缓存。\n     * @returns 当前矩形几何体\n     */\n    public updateGeometry(): this {\n        // 参数规范化不依赖填充面，边框独立生成时也使用相同的合法尺寸。\n        this._width = Number.isFinite(this._width) ? Math.max(0, this._width) : 0;\n        this._height = Number.isFinite(this._height) ? Math.max(0, this._height) : 0;\n        this._radius = Number.isFinite(this._radius)\n            ? Math.max(0, Math.min(this._radius, this._width * 0.5, this._height * 0.5))\n            : 0;\n        const geometry = this.style.solid.enabled\n            ? CreateRectGeometry(this._width, this._height, this._radius)\n            : undefined;\n\n        this.linePoints = this.style.wireframe.enabled\n            ? CreateRectLineGeometry(this._width, this._height, this._radius, 1)\n            : undefined;\n        const border = this.style.edge.enabled && this.style.edge.width > 0\n            ? CreateRectBorderGeometry(\n                this._width,\n                this._height,\n                this._radius,\n                this.style.edge.width,\n                this.style.edge.uvRepeat,\n                this.style.edge.borderAlign,\n            )\n            : undefined;\n        // 两个点位开关都关闭时不调用生成器，避免触发其参数校验。\n        const points = this.style.points.enabled && (this.style.points.vertices || this.style.points.midpoints)\n            ? CreateRectPointGeometry(\n                this._width, this._height, this._radius,\n                this.style.points.radius, this.style.points.segments,\n                this.style.points.vertices, this.style.points.midpoints,\n                this.style.points.minPointsLength, this.style.points.minEdgePointsLength,\n            )\n            : undefined;\n        const parts: { data: GeoPartDataLike; vertexType: number }[] = [];\n        if (geometry !== undefined) parts.push({ data: geometry, vertexType: 0 });\n        if (border !== undefined) parts.push({ data: border, vertexType: 0.5 });\n        if (points !== undefined) parts.push({ data: points, vertexType: 1 });\n        this.mergeGeometry(parts);\n        // Rect2d Shader 参数：宽度、高度、圆角半径、wide 三角面边框宽度。\n        this.uniformData.set([this._width, this._height, this._radius, this.style.edge.width]);\n        super.updateGeometry();\n        return this;\n    }\n\n    /**\n     * 设置矩形宽度并递增几何体版本。\n     * @param width 矩形宽度\n     */\n    public set width(width: number) {\n        if (this._width === width) {\n            return;\n        }\n\n        this._width = width;\n        this.updateVersion();\n    }\n\n    /**\n     * 获取矩形宽度。\n     * @returns 矩形宽度\n     */\n    public get width(): number {\n        return this._width;\n    }\n\n    /**\n     * 设置矩形高度并递增几何体版本。\n     * @param height 矩形高度\n     */\n    public set height(height: number) {\n        if (this._height === height) {\n            return;\n        }\n\n        this._height = height;\n        this.updateVersion();\n    }\n\n    /**\n     * 获取矩形高度。\n     * @returns 矩形高度\n     */\n    public get height(): number {\n        return this._height;\n    }\n\n    /**\n     * 设置圆角半径并递增几何体版本。\n     * @param radius 圆角半径\n     */\n    public set radius(radius: number) {\n        if (this._radius === radius) {\n            return;\n        }\n\n        this._radius = radius;\n        this.updateVersion();\n    }\n\n    /**\n     * 获取圆角半径。\n     * @returns 圆角半径\n     */\n    public get radius(): number {\n        return this._radius;\n    }\n\n    /**\n     * 获取矩形实际离散轮廓的只读周长。\n     * 结果使用与矩形几何体相同的圆角限制和分段规则。\n     * @returns 矩形轮廓周长\n     */\n    public get perimeter(): number {\n        return GetRectPerimeter(this._width, this._height, this._radius);\n    }\n}\nexport default Rect2d;\nexport type { Rect2dLike, Rect2dOptions };\n"],"mappings":";;;AAkCA,IAAM,SAAN,cAAqB,IAA0B;;;;CAI3C,OAA+B;;;;CAK/B;;;;CAKA;;;;CAKA;;;;;CAMA,YAAmB,UAAyB,CAAC,GAAG;EAC5C,MAAM,QAAQ,KAAK;EACnB,KAAK,SAAS,QAAQ,SAAS;EAC/B,KAAK,UAAU,QAAQ,UAAU;EACjC,KAAK,UAAU,QAAQ,UAAU;EACjC,KAAK,eAAe;CACxB;;;;;;CAOA,iBAA8B;EAE1B,KAAK,SAAS,OAAO,SAAS,KAAK,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,IAAI;EACxE,KAAK,UAAU,OAAO,SAAS,KAAK,OAAO,IAAI,KAAK,IAAI,GAAG,KAAK,OAAO,IAAI;EAC3E,KAAK,UAAU,OAAO,SAAS,KAAK,OAAO,IACrC,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,SAAS,KAAK,SAAS,IAAK,KAAK,UAAU,EAAG,CAAC,IACzE;EACN,MAAM,WAAW,KAAK,MAAM,MAAM,UAC5B,mBAAmB,KAAK,QAAQ,KAAK,SAAS,KAAK,OAAO,IAC1D,KAAA;EAEN,KAAK,aAAa,KAAK,MAAM,UAAU,UACjC,uBAAuB,KAAK,QAAQ,KAAK,SAAS,KAAK,SAAS,CAAC,IACjE,KAAA;EACN,MAAM,SAAS,KAAK,MAAM,KAAK,WAAW,KAAK,MAAM,KAAK,QAAQ,IAC5D,yBACE,KAAK,QACL,KAAK,SACL,KAAK,SACL,KAAK,MAAM,KAAK,OAChB,KAAK,MAAM,KAAK,UAChB,KAAK,MAAM,KAAK,WACpB,IACE,KAAA;EAEN,MAAM,SAAS,KAAK,MAAM,OAAO,YAAY,KAAK,MAAM,OAAO,YAAY,KAAK,MAAM,OAAO,aACvF,wBACE,KAAK,QAAQ,KAAK,SAAS,KAAK,SAChC,KAAK,MAAM,OAAO,QAAQ,KAAK,MAAM,OAAO,UAC5C,KAAK,MAAM,OAAO,UAAU,KAAK,MAAM,OAAO,WAC9C,KAAK,MAAM,OAAO,iBAAiB,KAAK,MAAM,OAAO,mBACzD,IACE,KAAA;EACN,MAAM,QAAyD,CAAC;EAChE,IAAI,aAAa,KAAA,GAAW,MAAM,KAAK;GAAE,MAAM;GAAU,YAAY;EAAE,CAAC;EACxE,IAAI,WAAW,KAAA,GAAW,MAAM,KAAK;GAAE,MAAM;GAAQ,YAAY;EAAI,CAAC;EACtE,IAAI,WAAW,KAAA,GAAW,MAAM,KAAK;GAAE,MAAM;GAAQ,YAAY;EAAE,CAAC;EACpE,KAAK,cAAc,KAAK;EAExB,KAAK,YAAY,IAAI;GAAC,KAAK;GAAQ,KAAK;GAAS,KAAK;GAAS,KAAK,MAAM,KAAK;EAAK,CAAC;EACrF,MAAM,eAAe;EACrB,OAAO;CACX;;;;;CAMA,IAAW,MAAM,OAAe;EAC5B,IAAI,KAAK,WAAW,OAChB;EAGJ,KAAK,SAAS;EACd,KAAK,cAAc;CACvB;;;;;CAMA,IAAW,QAAgB;EACvB,OAAO,KAAK;CAChB;;;;;CAMA,IAAW,OAAO,QAAgB;EAC9B,IAAI,KAAK,YAAY,QACjB;EAGJ,KAAK,UAAU;EACf,KAAK,cAAc;CACvB;;;;;CAMA,IAAW,SAAiB;EACxB,OAAO,KAAK;CAChB;;;;;CAMA,IAAW,OAAO,QAAgB;EAC9B,IAAI,KAAK,YAAY,QACjB;EAGJ,KAAK,UAAU;EACf,KAAK,cAAc;CACvB;;;;;CAMA,IAAW,SAAiB;EACxB,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,YAAoB;EAC3B,OAAO,iBAAiB,KAAK,QAAQ,KAAK,SAAS,KAAK,OAAO;CACnE;AACJ"}

package/lib/Geometry/index.d.ts

@@ -0,0 +1,6 @@
+export { default as Geo } from "./Geo";
+export { default as Rect2d } from "./Rect2d";
+export { default as Poly2D } from "./Poly2D";
+export type { Poly2DLike, Poly2DOptions } from "./Poly2D";
+export type { BorderAlign, GeoBuffersLike, GeoData, GeoPartDataLike, GeometrySubscriber } from "./Geo";
+export type { Rect2dLike, Rect2dOptions } from "./Rect2d";

package/lib/Geometry/index.js

@@ -0,0 +1,4 @@
+import Geo from "./Geo.js";
+import Rect2d from "./Rect2d.js";
+import Poly2D from "./Poly2D.js";
+export { Geo, Poly2D, Rect2d };