bplinejs 0.0.101-beta.10

package/lib/Camera/index.js

@@ -0,0 +1,178 @@
+import ObjectNode from "../Object/index.js";
+import { Mat3 } from "bpmatrixjs/Math/Mat3";
+//#region src/scripts/Camera/index.ts
+/** 正交相机：输入沿用节点单一版本，矩阵与每个 Render 独立保存处理快照。 */
+var Camera = class extends ObjectNode {
+	/** 对象类型。 */
+	type = "Camera";
+	_width;
+	_height;
+	_zoom;
+	_orthogonalMatrix = new Mat3();
+	_viewMatrix = new Mat3();
+	_projectionSnapshot = -1;
+	_viewWorldMatrix;
+	_viewWorldVersion = -1;
+	_writingCamera = false;
+	/** 保留的缓冲描述；实际 GPUBuffer 仍由 Render 持有。 */
+	buffers = {};
+	/** @param width 视口宽度 @param height 视口高度 @param zoom 缩放值 */
+	constructor(width = 100, height = 100, zoom = 1) {
+		super(0, 0);
+		this._width = width;
+		this._height = height;
+		this._zoom = zoom;
+		this._orthogonalMatrix.add(this, "orthogonalMatrix");
+		this._viewMatrix.add(this, "viewMatrix");
+		this.updateCameraMatrix();
+	}
+	/** 视口宽度。 */
+	get width() {
+		return this._width;
+	}
+	/** @param value 新宽度 */
+	set width(value) {
+		if (this._width === value) return;
+		this._width = value;
+		this.updateVersion();
+	}
+	/** 视口高度。 */
+	get height() {
+		return this._height;
+	}
+	/** @param value 新高度 */
+	set height(value) {
+		if (this._height === value) return;
+		this._height = value;
+		this.updateVersion();
+	}
+	/** 相机缩放。 */
+	get zoom() {
+		return this._zoom;
+	}
+	/** @param value 新缩放 */
+	set zoom(value) {
+		if (this._zoom === value) return;
+		this._zoom = value;
+		this.updateVersion();
+	}
+	/** 正交视口上边界。 */
+	get top() {
+		return this.height * .5 / this.zoom;
+	}
+	/** 正交视口下边界。 */
+	get bottom() {
+		return -this.height * .5 / this.zoom;
+	}
+	/** 正交视口左边界。 */
+	get left() {
+		return -this.width * .5 / this.zoom;
+	}
+	/** 正交视口右边界。 */
+	get right() {
+		return this.width * .5 / this.zoom;
+	}
+	/** 投影矩阵，GPU 上传比较矩阵版本。 */
+	get orthogonalMatrix() {
+		return this._orthogonalMatrix;
+	}
+	/** @param value 新投影矩阵，替换引用也使 Render 缓存失效 */
+	set orthogonalMatrix(value) {
+		if (this._orthogonalMatrix === value) return;
+		this._orthogonalMatrix.delete(this, "orthogonalMatrix");
+		this._orthogonalMatrix = value;
+		value.add(this, "orthogonalMatrix");
+		this.onMathChange(value, "orthogonalMatrix");
+	}
+	/** 视图矩阵，通常为世界矩阵的逆。 */
+	get viewMatrix() {
+		return this._viewMatrix;
+	}
+	/** @param value 新视图矩阵 */
+	set viewMatrix(value) {
+		if (this._viewMatrix === value) return;
+		this._viewMatrix.delete(this, "viewMatrix");
+		this._viewMatrix = value;
+		value.add(this, "viewMatrix");
+		this.onMathChange(value, "viewMatrix");
+	}
+	/** @param source 数学对象 @param field 关联字段 */
+	onMathChange(source, field) {
+		if (this._nodeDisposed) return;
+		if (field === "orthogonalMatrix" && source === this._orthogonalMatrix || field === "viewMatrix" && source === this._viewMatrix) {
+			if (this._writingCamera) return;
+			this.updateVersion();
+			if (field === "orthogonalMatrix") this._projectionSnapshot = this.version;
+			else {
+				this._viewWorldMatrix = this.worldMatrix;
+				this._viewWorldVersion = this.worldMatrix.version;
+			}
+		} else super.onMathChange(source, field);
+	}
+	/** @param width 新视口宽度 @param height 新视口高度 */
+	setViewport(width = 100, height = 100) {
+		if (this._width === width && this._height === height) return;
+		this._width = width;
+		this._height = height;
+		this.updateVersion();
+	}
+	/** 相机不提供子节点容器。 */
+	add() {
+		throw new Error("Camera does not support add().");
+	}
+	/** 在渲染前更新版本落后的矩阵；支持相机挂在 Group/Mesh 内以及独立相机。 */
+	ensureCameraMatrix() {
+		this.ensureWorldMatrix();
+		if (this._projectionSnapshot !== this.version) this.updateOrthogonalMatrix();
+		if (this._viewWorldMatrix !== this.worldMatrix || this._viewWorldVersion !== this.worldMatrix.version) this.updateViewMatrix();
+	}
+	/** 强制计算投影矩阵，保持 Y 正方向向上。 */
+	updateOrthogonalMatrix() {
+		this._writingCamera = true;
+		try {
+			this._orthogonalMatrix.set([
+				2 * this.zoom / this.width,
+				0,
+				0,
+				0,
+				2 * this.zoom / this.height,
+				0,
+				0,
+				0,
+				1
+			]);
+			this._projectionSnapshot = this.version;
+		} finally {
+			this._writingCamera = false;
+		}
+		return this._orthogonalMatrix;
+	}
+	/** 先确保父级与自身世界矩阵有效，再计算逆矩阵。 */
+	updateViewMatrix() {
+		this.ensureWorldMatrix();
+		this._writingCamera = true;
+		try {
+			this._viewMatrix.copy(this.worldMatrix).invert();
+			this._viewWorldMatrix = this.worldMatrix;
+			this._viewWorldVersion = this.worldMatrix.version;
+		} finally {
+			this._writingCamera = false;
+		}
+		return this._viewMatrix;
+	}
+	/** 强制更新投影矩阵和视图矩阵。 */
+	updateCameraMatrix() {
+		this.updateOrthogonalMatrix();
+		this.updateViewMatrix();
+	}
+	/** 最终释放相机对所有数学对象的订阅，不销毁共享矩阵。 */
+	dispose() {
+		this._orthogonalMatrix.delete(this, "orthogonalMatrix");
+		this._viewMatrix.delete(this, "viewMatrix");
+		super.dispose();
+	}
+};
+//#endregion
+export { Camera as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Camera/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Camera/index.ts"],"sourcesContent":["import ObjectNode from \"../Object\";\nimport type { ObjectNodeLike } from \"../Object\";\nimport { Mat3 } from \"bpmatrixjs/Math/Mat3\";\nimport type { VersionedMath } from \"bpmatrixjs/Math\";\n\ninterface CameraBuffersLike {\n    uniform?: number;\n}\ninterface CameraLike extends ObjectNodeLike {\n    zoom: number;\n    width: number;\n    height: number;\n    orthogonalMatrix: Mat3;\n    viewMatrix: Mat3;\n    buffers: CameraBuffersLike;\n    readonly top: number;\n    readonly left: number;\n    readonly bottom: number;\n    readonly right: number;\n    setViewport(width: number, height: number): void;\n    ensureCameraMatrix(): void;\n    updateOrthogonalMatrix(): Mat3;\n    updateViewMatrix(): Mat3;\n    updateCameraMatrix(): void;\n}\n\n/** 正交相机：输入沿用节点单一版本，矩阵与每个 Render 独立保存处理快照。 */\nclass Camera extends ObjectNode implements CameraLike {\n    /** 对象类型。 */\n    public readonly type: string = \"Camera\";\n    private _width: number;\n    private _height: number;\n    private _zoom: number;\n    private _orthogonalMatrix = new Mat3();\n    private _viewMatrix = new Mat3();\n    private _projectionSnapshot: number = -1;\n    private _viewWorldMatrix: Mat3 | undefined;\n    private _viewWorldVersion: number = -1;\n    private _writingCamera: boolean = false;\n    /** 保留的缓冲描述；实际 GPUBuffer 仍由 Render 持有。 */\n    public buffers: CameraBuffersLike = {};\n\n    /** @param width 视口宽度 @param height 视口高度 @param zoom 缩放值 */\n    public constructor(width: number = 100, height: number = 100, zoom: number = 1) {\n        super(0, 0);\n        this._width = width;\n        this._height = height;\n        this._zoom = zoom;\n        this._orthogonalMatrix.add(this, \"orthogonalMatrix\");\n        this._viewMatrix.add(this, \"viewMatrix\");\n        this.updateCameraMatrix();\n    }\n\n    /** 视口宽度。 */\n    public get width(): number { return this._width; }\n    /** @param value 新宽度 */\n    public set width(value: number) {\n        if (this._width === value) return;\n        this._width = value;\n        this.updateVersion();\n    }\n    /** 视口高度。 */\n    public get height(): number { return this._height; }\n    /** @param value 新高度 */\n    public set height(value: number) {\n        if (this._height === value) return;\n        this._height = value;\n        this.updateVersion();\n    }\n    /** 相机缩放。 */\n    public get zoom(): number { return this._zoom; }\n    /** @param value 新缩放 */\n    public set zoom(value: number) {\n        if (this._zoom === value) return;\n        this._zoom = value;\n        this.updateVersion();\n    }\n    /** 正交视口上边界。 */\n    public get top(): number { return this.height * 0.5 / this.zoom; }\n    /** 正交视口下边界。 */\n    public get bottom(): number { return -this.height * 0.5 / this.zoom; }\n    /** 正交视口左边界。 */\n    public get left(): number { return -this.width * 0.5 / this.zoom; }\n    /** 正交视口右边界。 */\n    public get right(): number { return this.width * 0.5 / this.zoom; }\n\n    /** 投影矩阵，GPU 上传比较矩阵版本。 */\n    public get orthogonalMatrix(): Mat3 { return this._orthogonalMatrix; }\n    /** @param value 新投影矩阵，替换引用也使 Render 缓存失效 */\n    public set orthogonalMatrix(value: Mat3) {\n        if (this._orthogonalMatrix === value) return;\n        this._orthogonalMatrix.delete(this, \"orthogonalMatrix\");\n        this._orthogonalMatrix = value;\n        value.add(this, \"orthogonalMatrix\");\n        this.onMathChange(value, \"orthogonalMatrix\");\n    }\n    /** 视图矩阵，通常为世界矩阵的逆。 */\n    public get viewMatrix(): Mat3 { return this._viewMatrix; }\n    /** @param value 新视图矩阵 */\n    public set viewMatrix(value: Mat3) {\n        if (this._viewMatrix === value) return;\n        this._viewMatrix.delete(this, \"viewMatrix\");\n        this._viewMatrix = value;\n        value.add(this, \"viewMatrix\");\n        this.onMathChange(value, \"viewMatrix\");\n    }\n\n    /** @param source 数学对象 @param field 关联字段 */\n    public override onMathChange(source: VersionedMath, field: string): void {\n        if (this._nodeDisposed) return;\n        if ((field === \"orthogonalMatrix\" && source === this._orthogonalMatrix)\n            || (field === \"viewMatrix\" && source === this._viewMatrix)) {\n            if (this._writingCamera) return;\n            this.updateVersion();\n            if (field === \"orthogonalMatrix\") this._projectionSnapshot = this.version;\n            else {\n                this._viewWorldMatrix = this.worldMatrix;\n                this._viewWorldVersion = this.worldMatrix.version;\n            }\n        } else super.onMathChange(source, field);\n    }\n\n    /** @param width 新视口宽度 @param height 新视口高度 */\n    public setViewport(width: number = 100, height: number = 100): void {\n        if (this._width === width && this._height === height) return;\n        this._width = width;\n        this._height = height;\n        this.updateVersion();\n    }\n    /** 相机不提供子节点容器。 */\n    public add(): void { throw new Error(\"Camera does not support add().\"); }\n\n    /** 在渲染前更新版本落后的矩阵；支持相机挂在 Group/Mesh 内以及独立相机。 */\n    public ensureCameraMatrix(): void {\n        this.ensureWorldMatrix();\n        if (this._projectionSnapshot !== this.version) this.updateOrthogonalMatrix();\n        if (this._viewWorldMatrix !== this.worldMatrix || this._viewWorldVersion !== this.worldMatrix.version) {\n            this.updateViewMatrix();\n        }\n    }\n\n    /** 强制计算投影矩阵，保持 Y 正方向向上。 */\n    public updateOrthogonalMatrix(): Mat3 {\n        this._writingCamera = true;\n        try {\n            this._orthogonalMatrix.set([\n                2 * this.zoom / this.width, 0, 0,\n                0, 2 * this.zoom / this.height, 0,\n                0, 0, 1,\n            ]);\n            this._projectionSnapshot = this.version;\n        } finally {\n            this._writingCamera = false;\n        }\n        return this._orthogonalMatrix;\n    }\n\n    /** 先确保父级与自身世界矩阵有效，再计算逆矩阵。 */\n    public updateViewMatrix(): Mat3 {\n        this.ensureWorldMatrix();\n        this._writingCamera = true;\n        try {\n            this._viewMatrix.copy(this.worldMatrix).invert();\n            this._viewWorldMatrix = this.worldMatrix;\n            this._viewWorldVersion = this.worldMatrix.version;\n        } finally {\n            this._writingCamera = false;\n        }\n        return this._viewMatrix;\n    }\n\n    /** 强制更新投影矩阵和视图矩阵。 */\n    public updateCameraMatrix(): void {\n        this.updateOrthogonalMatrix();\n        this.updateViewMatrix();\n    }\n\n    /** 最终释放相机对所有数学对象的订阅，不销毁共享矩阵。 */\n    public override dispose(): void {\n        this._orthogonalMatrix.delete(this, \"orthogonalMatrix\");\n        this._viewMatrix.delete(this, \"viewMatrix\");\n        super.dispose();\n    }\n}\nexport default Camera;\nexport type { CameraBuffersLike, CameraLike };\n"],"mappings":"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"}

package/lib/Color/index.d.ts

@@ -0,0 +1,99 @@
+/** 接收颜色变化的对象；字段标识允许同一对象的多个属性共用一个 Color。 */
+export interface ColorSubscriber {
+    onColorChange(color: Color, field: string): void;
+}
+/** 归一化 RGBA 颜色；所有修改入口都会在值实际变化后通知订阅者。 */
+declare class Color {
+    private readonly _data;
+    private readonly _subscribers;
+    /**
+     * 创建颜色，默认不透明白色；数字十六进制按 RRGGBB 解释。
+     * @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB
+     */
+    constructor(hex?: string | number);
+    /** 获取红分量，范围 0 到 1。 */
+    get r(): number;
+    /**
+     * 设置红分量，有限值会钳制到 0 到 1。
+     * @param value 归一化分量
+     */
+    set r(value: number);
+    /** 获取绿分量，范围 0 到 1。 */
+    get g(): number;
+    /**
+     * 设置绿分量，有限值会钳制到 0 到 1。
+     * @param value 归一化分量
+     */
+    set g(value: number);
+    /** 获取蓝分量，范围 0 到 1。 */
+    get b(): number;
+    /**
+     * 设置蓝分量，有限值会钳制到 0 到 1。
+     * @param value 归一化分量
+     */
+    set b(value: number);
+    /** 获取透明度分量，范围 0 到 1。 */
+    get a(): number;
+    /**
+     * 设置透明度分量，有限值会钳制到 0 到 1。
+     * @param value 归一化分量
+     */
+    set a(value: number);
+    /**
+     * 批量设置 RGB，保留当前 alpha，只通知一次。
+     * @param r 红色，0 到 1
+     * @param g 绿色，0 到 1
+     * @param b 蓝色，0 到 1
+     * @returns 当前颜色
+     */
+    setRGB(r: number, g: number, b: number): this;
+    /**
+     * 批量设置 RGBA，验证成功后统一提交，只通知一次。
+     * @param r 红色，0 到 1
+     * @param g 绿色，0 到 1
+     * @param b 蓝色，0 到 1
+     * @param a 透明度，0 到 1
+     * @returns 当前颜色
+     */
+    setRGBA(r: number, g: number, b: number, a?: number): this;
+    /**
+     * 设置十六进制颜色；没有 alpha 的格式使用不透明值。
+     * @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB
+     * @returns 当前颜色
+     */
+    setHex(hex: string | number): this;
+    /**
+     * 转为十六进制文本，不做额外颜色空间变换。
+     * @param alpha 是否包含 alpha
+     * @returns #rrggbb 或 #rrggbbaa
+     */
+    toHex(alpha?: boolean): string;
+    /**
+     * 将 RGBA 写入调用者数组，不暴露内部可变数据。
+     * @param target 目标数组
+     * @param offset 分量偏移，不是字节偏移
+     * @returns 目标数组
+     */
+    writeTo(target: Float32Array<ArrayBuffer>, offset?: number): Float32Array<ArrayBuffer>;
+    /**
+     * 复制颜色数值，不共享订阅者。
+     * @param color 来源颜色
+     * @returns 当前颜色
+     */
+    copy(color: Color): this;
+    /** 创建没有订阅者的独立颜色副本。 */
+    clone(): Color;
+    /**
+     * 登记订阅关系，同一对象的不同颜色字段分别计数。
+     * @param subscriber 接收变化的对象
+     * @param field 对象内的颜色字段名
+     */
+    add(subscriber: ColorSubscriber, field?: string): void;
+    /**
+     * 解除单个字段订阅；省略字段时解除该对象全部订阅。
+     * @param subscriber 接收变化的对象
+     * @param field 要解除的颜色字段
+     */
+    delete(subscriber: ColorSubscriber, field?: string): void;
+}
+export default Color;

package/lib/Color/index.js

@@ -0,0 +1,178 @@
+//#region src/scripts/Color/index.ts
+/** 归一化 RGBA 颜色；所有修改入口都会在值实际变化后通知订阅者。 */
+var Color = class Color {
+	_data = [
+		1,
+		1,
+		1,
+		1
+	];
+	_subscribers = /* @__PURE__ */ new Map();
+	/**
+	* 创建颜色，默认不透明白色；数字十六进制按 RRGGBB 解释。
+	* @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB
+	*/
+	constructor(hex = "#ffffff") {
+		this.setHex(hex);
+	}
+	/** 获取红分量，范围 0 到 1。 */
+	get r() {
+		return this._data[0];
+	}
+	/**
+	* 设置红分量，有限值会钳制到 0 到 1。
+	* @param value 归一化分量
+	*/
+	set r(value) {
+		const data = [...this._data];
+		data[0] = value;
+		this.setRGBA(data[0], data[1], data[2], data[3]);
+	}
+	/** 获取绿分量，范围 0 到 1。 */
+	get g() {
+		return this._data[1];
+	}
+	/**
+	* 设置绿分量，有限值会钳制到 0 到 1。
+	* @param value 归一化分量
+	*/
+	set g(value) {
+		const data = [...this._data];
+		data[1] = value;
+		this.setRGBA(data[0], data[1], data[2], data[3]);
+	}
+	/** 获取蓝分量，范围 0 到 1。 */
+	get b() {
+		return this._data[2];
+	}
+	/**
+	* 设置蓝分量，有限值会钳制到 0 到 1。
+	* @param value 归一化分量
+	*/
+	set b(value) {
+		const data = [...this._data];
+		data[2] = value;
+		this.setRGBA(data[0], data[1], data[2], data[3]);
+	}
+	/** 获取透明度分量，范围 0 到 1。 */
+	get a() {
+		return this._data[3];
+	}
+	/**
+	* 设置透明度分量，有限值会钳制到 0 到 1。
+	* @param value 归一化分量
+	*/
+	set a(value) {
+		const data = [...this._data];
+		data[3] = value;
+		this.setRGBA(data[0], data[1], data[2], data[3]);
+	}
+	/**
+	* 批量设置 RGB，保留当前 alpha，只通知一次。
+	* @param r 红色，0 到 1
+	* @param g 绿色，0 到 1
+	* @param b 蓝色，0 到 1
+	* @returns 当前颜色
+	*/
+	setRGB(r, g, b) {
+		return this.setRGBA(r, g, b, this.a);
+	}
+	/**
+	* 批量设置 RGBA，验证成功后统一提交，只通知一次。
+	* @param r 红色，0 到 1
+	* @param g 绿色，0 到 1
+	* @param b 蓝色，0 到 1
+	* @param a 透明度，0 到 1
+	* @returns 当前颜色
+	*/
+	setRGBA(r, g, b, a = 1) {
+		const values = [
+			r,
+			g,
+			b,
+			a
+		];
+		if (!values.every(Number.isFinite)) throw new RangeError("Color components must be finite.");
+		const normalized = values.map((value) => Math.min(1, Math.max(0, value)));
+		if (normalized.every((value, index) => value === this._data[index])) return this;
+		this._data.splice(0, 4, ...normalized);
+		for (const [subscriber, fields] of [...this._subscribers]) for (const field of [...fields]) subscriber.onColorChange(this, field);
+		return this;
+	}
+	/**
+	* 设置十六进制颜色；没有 alpha 的格式使用不透明值。
+	* @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB
+	* @returns 当前颜色
+	*/
+	setHex(hex) {
+		if (typeof hex === "number" && (!Number.isInteger(hex) || hex < 0 || hex > 16777215)) throw new RangeError("Numeric hex colors must be between 0x000000 and 0xffffff.");
+		let text = typeof hex === "number" ? hex.toString(16).padStart(6, "0") : hex.replace(/^#/, "");
+		if (!/^(?:[0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(text)) throw new TypeError("Invalid hex color.");
+		if (text.length <= 4) text = text.replace(/./g, (digit) => digit + digit);
+		if (text.length === 6) text += "ff";
+		return this.setRGBA(...[
+			0,
+			2,
+			4,
+			6
+		].map((offset) => parseInt(text.slice(offset, offset + 2), 16) / 255));
+	}
+	/**
+	* 转为十六进制文本，不做额外颜色空间变换。
+	* @param alpha 是否包含 alpha
+	* @returns #rrggbb 或 #rrggbbaa
+	*/
+	toHex(alpha = false) {
+		return "#" + this._data.slice(0, alpha ? 4 : 3).map((value) => Math.round(value * 255).toString(16).padStart(2, "0")).join("");
+	}
+	/**
+	* 将 RGBA 写入调用者数组，不暴露内部可变数据。
+	* @param target 目标数组
+	* @param offset 分量偏移，不是字节偏移
+	* @returns 目标数组
+	*/
+	writeTo(target, offset = 0) {
+		target.set(this._data, offset);
+		return target;
+	}
+	/**
+	* 复制颜色数值，不共享订阅者。
+	* @param color 来源颜色
+	* @returns 当前颜色
+	*/
+	copy(color) {
+		return this.setRGBA(color.r, color.g, color.b, color.a);
+	}
+	/** 创建没有订阅者的独立颜色副本。 */
+	clone() {
+		return new Color().copy(this);
+	}
+	/**
+	* 登记订阅关系，同一对象的不同颜色字段分别计数。
+	* @param subscriber 接收变化的对象
+	* @param field 对象内的颜色字段名
+	*/
+	add(subscriber, field = "color") {
+		const fields = this._subscribers.get(subscriber) ?? /* @__PURE__ */ new Set();
+		fields.add(field);
+		this._subscribers.set(subscriber, fields);
+	}
+	/**
+	* 解除单个字段订阅；省略字段时解除该对象全部订阅。
+	* @param subscriber 接收变化的对象
+	* @param field 要解除的颜色字段
+	*/
+	delete(subscriber, field) {
+		if (field === void 0) {
+			this._subscribers.delete(subscriber);
+			return;
+		}
+		const fields = this._subscribers.get(subscriber);
+		fields?.delete(field);
+		if (fields?.size === 0) this._subscribers.delete(subscriber);
+	}
+};
+//#endregion
+export { Color as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Color/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Color/index.ts"],"sourcesContent":["/** 接收颜色变化的对象；字段标识允许同一对象的多个属性共用一个 Color。 */\nexport interface ColorSubscriber {\n    onColorChange(color: Color, field: string): void;\n}\n\n/** 归一化 RGBA 颜色；所有修改入口都会在值实际变化后通知订阅者。 */\nclass Color {\n    private readonly _data: number[] = [1, 1, 1, 1];\n    private readonly _subscribers = new Map<ColorSubscriber, Set<string>>();\n\n    /**\n     * 创建颜色，默认不透明白色；数字十六进制按 RRGGBB 解释。\n     * @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB\n     */\n    public constructor(hex: string | number = \"#ffffff\") {\n        this.setHex(hex);\n    }\n\n    /** 获取红分量，范围 0 到 1。 */\n    public get r(): number { return this._data[0]; }\n    /**\n     * 设置红分量，有限值会钳制到 0 到 1。\n     * @param value 归一化分量\n     */\n    public set r(value: number) {\n        const data = [...this._data];\n        data[0] = value;\n        this.setRGBA(data[0], data[1], data[2], data[3]);\n    }\n\n    /** 获取绿分量，范围 0 到 1。 */\n    public get g(): number { return this._data[1]; }\n    /**\n     * 设置绿分量，有限值会钳制到 0 到 1。\n     * @param value 归一化分量\n     */\n    public set g(value: number) {\n        const data = [...this._data];\n        data[1] = value;\n        this.setRGBA(data[0], data[1], data[2], data[3]);\n    }\n\n    /** 获取蓝分量，范围 0 到 1。 */\n    public get b(): number { return this._data[2]; }\n    /**\n     * 设置蓝分量，有限值会钳制到 0 到 1。\n     * @param value 归一化分量\n     */\n    public set b(value: number) {\n        const data = [...this._data];\n        data[2] = value;\n        this.setRGBA(data[0], data[1], data[2], data[3]);\n    }\n\n    /** 获取透明度分量，范围 0 到 1。 */\n    public get a(): number { return this._data[3]; }\n    /**\n     * 设置透明度分量，有限值会钳制到 0 到 1。\n     * @param value 归一化分量\n     */\n    public set a(value: number) {\n        const data = [...this._data];\n        data[3] = value;\n        this.setRGBA(data[0], data[1], data[2], data[3]);\n    }\n\n    /**\n     * 批量设置 RGB，保留当前 alpha，只通知一次。\n     * @param r 红色，0 到 1\n     * @param g 绿色，0 到 1\n     * @param b 蓝色，0 到 1\n     * @returns 当前颜色\n     */\n    public setRGB(r: number, g: number, b: number): this {\n        return this.setRGBA(r, g, b, this.a);\n    }\n\n    /**\n     * 批量设置 RGBA，验证成功后统一提交，只通知一次。\n     * @param r 红色，0 到 1\n     * @param g 绿色，0 到 1\n     * @param b 蓝色，0 到 1\n     * @param a 透明度，0 到 1\n     * @returns 当前颜色\n     */\n    public setRGBA(r: number, g: number, b: number, a: number = 1): this {\n        const values = [r, g, b, a];\n        if (!values.every(Number.isFinite)) throw new RangeError(\"Color components must be finite.\");\n        const normalized = values.map((value: number): number => Math.min(1, Math.max(0, value)));\n        if (normalized.every((value: number, index: number): boolean => value === this._data[index])) return this;\n        this._data.splice(0, 4, ...normalized);\n        for (const [subscriber, fields] of [...this._subscribers]) {\n            for (const field of [...fields]) subscriber.onColorChange(this, field);\n        }\n        return this;\n    }\n\n    /**\n     * 设置十六进制颜色；没有 alpha 的格式使用不透明值。\n     * @param hex #RGB、#RGBA、#RRGGBB、#RRGGBBAA 或 0xRRGGBB\n     * @returns 当前颜色\n     */\n    public setHex(hex: string | number): this {\n        if (typeof hex === \"number\" && (!Number.isInteger(hex) || hex < 0 || hex > 0xffffff)) {\n            throw new RangeError(\"Numeric hex colors must be between 0x000000 and 0xffffff.\");\n        }\n        let text: string = typeof hex === \"number\" ? hex.toString(16).padStart(6, \"0\") : hex.replace(/^#/, \"\");\n        if (!/^(?:[0-9a-f]{3}|[0-9a-f]{4}|[0-9a-f]{6}|[0-9a-f]{8})$/i.test(text)) {\n            throw new TypeError(\"Invalid hex color.\");\n        }\n        if (text.length <= 4) text = text.replace(/./g, (digit: string): string => digit + digit);\n        if (text.length === 6) text += \"ff\";\n        return this.setRGBA(...[0, 2, 4, 6].map((offset: number): number => parseInt(text.slice(offset, offset + 2), 16) / 255) as [number, number, number, number]);\n    }\n\n    /**\n     * 转为十六进制文本，不做额外颜色空间变换。\n     * @param alpha 是否包含 alpha\n     * @returns #rrggbb 或 #rrggbbaa\n     */\n    public toHex(alpha: boolean = false): string {\n        return \"#\" + this._data.slice(0, alpha ? 4 : 3)\n            .map((value: number): string => Math.round(value * 255).toString(16).padStart(2, \"0\")).join(\"\");\n    }\n\n    /**\n     * 将 RGBA 写入调用者数组，不暴露内部可变数据。\n     * @param target 目标数组\n     * @param offset 分量偏移，不是字节偏移\n     * @returns 目标数组\n     */\n    public writeTo(target: Float32Array<ArrayBuffer>, offset: number = 0): Float32Array<ArrayBuffer> {\n        target.set(this._data, offset);\n        return target;\n    }\n\n    /**\n     * 复制颜色数值，不共享订阅者。\n     * @param color 来源颜色\n     * @returns 当前颜色\n     */\n    public copy(color: Color): this { return this.setRGBA(color.r, color.g, color.b, color.a); }\n\n    /** 创建没有订阅者的独立颜色副本。 */\n    public clone(): Color { return new Color().copy(this); }\n\n    /**\n     * 登记订阅关系，同一对象的不同颜色字段分别计数。\n     * @param subscriber 接收变化的对象\n     * @param field 对象内的颜色字段名\n     */\n    public add(subscriber: ColorSubscriber, field: string = \"color\"): void {\n        const fields = this._subscribers.get(subscriber) ?? new Set<string>();\n        fields.add(field);\n        this._subscribers.set(subscriber, fields);\n    }\n\n    /**\n     * 解除单个字段订阅；省略字段时解除该对象全部订阅。\n     * @param subscriber 接收变化的对象\n     * @param field 要解除的颜色字段\n     */\n    public delete(subscriber: ColorSubscriber, field?: string): void {\n        if (field === undefined) { this._subscribers.delete(subscriber); return; }\n        const fields = this._subscribers.get(subscriber);\n        fields?.delete(field);\n        if (fields?.size === 0) this._subscribers.delete(subscriber);\n    }\n}\nexport default Color;\n"],"mappings":"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"}

package/lib/Geometry/Geo.d.ts

@@ -0,0 +1,131 @@
+import Style from "../Style";
+import type { StyleChange, StyleSubscriber } from "../Style";
+/** 边框对齐类型沿用 Style 定义。 */
+import type { BorderAlign } from "../Style";
+interface GeoBuffersLike {
+    vertex?: number;
+    normal?: number;
+    uv?: number;
+    index?: number;
+}
+/** 单个几何分区的顶点属性。 */
+interface GeoPartDataLike {
+    geometry: Float32Array;
+    normal: Float32Array;
+    uv: Float32Array;
+    index: Uint16Array | Uint32Array;
+    /** 点型逐顶点中心坐标，长度与 geometry 相同。 */
+    position?: Float32Array;
+    /** 每个顶点的用途：0 为实体面，0.5 为宽边框，1 为关键点。 */
+    vertexType?: Float32Array;
+    miterScale?: Float32Array;
+}
+/** 几何消费者；通知只标记后续工作，不在回调中生成几何或操作 GPU。 */
+interface GeometrySubscriber {
+    onGeometryChange(geometry: GeoData): void;
+}
+interface GeoData extends StyleSubscriber {
+    readonly id: number;
+    readonly type: string;
+    readonly version: number;
+    style: Style;
+    geometry: Float32Array | undefined;
+    normal: Float32Array | undefined;
+    uv: Float32Array | undefined;
+    index: Uint16Array | Uint32Array | undefined;
+    linePoints: GeoPartDataLike | undefined;
+    vertexType: Float32Array | undefined;
+    position: Float32Array | undefined;
+    miterScale: Float32Array | undefined;
+    readonly uniformData: Float32Array<ArrayBuffer>;
+    add(subscriber: GeometrySubscriber): void;
+    delete(subscriber: GeometrySubscriber): void;
+    updateVersion(): void;
+    ensureGeometry(): this;
+    updateGeometry(): this;
+    dispose(): void;
+}
+/** CPU 几何及其单一版本；样式订阅只响应影响几何生成的字段。 */
+declare class Geo implements GeoData {
+    /** 全局几何 ID。 */
+    readonly id: number;
+    /** 对象类型。 */
+    readonly type: string;
+    private _version;
+    private _generatedVersion;
+    private _style;
+    private _disposed;
+    private readonly _subscribers;
+    /** 合并三角面坐标。 */
+    protected _geometry: Float32Array | undefined;
+    /** 逐顶点二维轮廓法线。 */
+    normal: Float32Array | undefined;
+    /** 逐顶点 UV。 */
+    uv: Float32Array | undefined;
+    /** 合并三角面索引。 */
+    index: Uint16Array | Uint32Array | undefined;
+    /** 独立 line-list 几何。 */
+    linePoints: GeoPartDataLike | undefined;
+    /** 顶点用途：0 实体面、0.5 边框、1 关键点。 */
+    vertexType: Float32Array | undefined;
+    /** 关键点中心，其他顶点填零。 */
+    position: Float32Array | undefined;
+    /** 边框连接倍率，其他顶点填一。 */
+    miterScale: Float32Array | undefined;
+    /** 宽高、圆角和实体边框宽度。 */
+    readonly uniformData: Float32Array<ArrayBuffer>;
+    /** @param style 共享样式，默认四个分区全部关闭 */
+    constructor(style?: Style);
+    /** 当前共享样式，分区 enabled 决定生成内容。 */
+    get style(): Style;
+    /** @param value 新样式，先解绑旧样式并使全部几何缓存失效 */
+    set style(value: Style);
+    /**
+     * 只让几何依赖的字段触发重建，颜色和透明度不影响顶点。
+     * @param change 样式通知
+     */
+    onStyleChange(change: StyleChange): void;
+    /** 最终停止使用时解绑 Style；不等于从 Scene 移除，不销毁 Render 缓存。 */
+    dispose(): void;
+    /**
+     * 关联使用当前几何的消费者，重复关联不会重复通知。
+     * @param subscriber Mesh 或其他几何消费者
+     */
+    add(subscriber: GeometrySubscriber): void;
+    /**
+     * 解绑消费者，不销毁共享几何或 GPU 缓存。
+     * @param subscriber 需要解绑的消费者
+     */
+    delete(subscriber: GeometrySubscriber): void;
+    /**
+     * 获取合并三角面的二维顶点数组。
+     * @returns 顶点数组，未生成三角面时为 undefined
+     */
+    get geometry(): Float32Array | undefined;
+    /**
+     * 替换合并三角面顶点数组并通知 GPU 缓存更新。
+     * 已生成的 CPU 数据直接提交；尚未生成的参数变化仍由 ensureGeometry 处理。
+     * @param geometry 新顶点数组
+     */
+    set geometry(geometry: Float32Array | undefined);
+    /**
+     * 按实体面、宽边框、关键点顺序合并全部三角面并补齐顶点属性。
+     * 索引按顶点偏移重新定位，顶点数量超过 Uint16 范围时自动升级位宽。
+     * @param parts 本次启用的几何分区
+     * @returns 无返回值
+     */
+    protected mergeGeometry(parts: {
+        data: GeoPartDataLike;
+        vertexType: number;
+    }[]): void;
+    /** 当前几何版本。 */
+    get version(): number;
+    /** 通知 CPU 生成器及每个 Render 更新缓存。 */
+    updateVersion(): void;
+    /** 参数变化后延迟生成，一帧内多次改值只生成一次。 */
+    ensureGeometry(): this;
+    /** 提交生成的数据；手动调用也会递增版本，通知每个 Render。 */
+    updateGeometry(): this;
+}
+export default Geo;
+export type { BorderAlign, GeoBuffersLike, GeoData, GeoPartDataLike, GeometrySubscriber };