bplinejs 0.0.101-beta.10

package/lib/Object/index.js

@@ -0,0 +1,212 @@
+import { GETID } from "../ID.js";
+import { Vec2 } from "bpmatrixjs/Math/Vec2";
+import { Mat3 } from "bpmatrixjs/Math/Mat3";
+//#region src/scripts/Object/index.ts
+/** 场景节点变换基类：参数持有一个版本，计算结果和每个消费者各存处理快照。 */
+var ObjectNode = class {
+	/** 全局节点 ID。 */
+	id = GETID();
+	/** 节点类型。 */
+	type = "ObjectNode";
+	_version = 0;
+	_parent = null;
+	_position;
+	_rotation = 0;
+	_scale;
+	_matrix = new Mat3();
+	_worldMatrix = new Mat3();
+	_order = 0;
+	_localSnapshot = -1;
+	_worldSnapshot = -1;
+	_parentSnapshot = null;
+	_parentVersion = -1;
+	_writingMatrices = false;
+	_nodeDisposed = false;
+	/** @param x 初始 X 坐标 @param y 初始 Y 坐标 */
+	constructor(x, y) {
+		this._position = new Vec2(x, y);
+		this._scale = new Vec2(1, 1);
+		this._position.add(this, "position");
+		this._scale.add(this, "scale");
+		this._matrix.add(this, "matrix");
+		this._worldMatrix.add(this, "worldMatrix");
+	}
+	/** 节点输入版本；计算快照不会清除或回退它。 */
+	get version() {
+		return this._version;
+	}
+	/** 手动使变换失效；普通 position/scale/rotation 修改已自动通知。 */
+	updateVersion() {
+		this._version++;
+	}
+	/** 父节点，场景树结构请通过 Group.add/remove 修改。 */
+	get parent() {
+		return this._parent;
+	}
+	/** @param value 父引用，Group 维护 children 与 Scene 列表 */
+	set parent(value) {
+		if (this._parent === value) return;
+		this._parent = value;
+		this.updateVersion();
+	}
+	/** 位置向量，内部 set/setX/x 赋值均能通知。 */
+	get position() {
+		return this._position;
+	}
+	/** @param value 新位置向量，替换时解绑旧字段 */
+	set position(value) {
+		if (this._position === value) return;
+		this._position.delete(this, "position");
+		this._position = value;
+		value.add(this, "position");
+		this.updateVersion();
+	}
+	/** 本地旋转弧度。 */
+	get rotation() {
+		return this._rotation;
+	}
+	/** @param value 新旋转弧度 */
+	set rotation(value) {
+		if (this._rotation === value) return;
+		this._rotation = value;
+		this.updateVersion();
+	}
+	/** 缩放向量，可与其他节点共享。 */
+	get scale() {
+		return this._scale;
+	}
+	/** @param value 新缩放向量 */
+	set scale(value) {
+		if (this._scale === value) return;
+		this._scale.delete(this, "scale");
+		this._scale = value;
+		value.add(this, "scale");
+		this.updateVersion();
+	}
+	/** 本地矩阵；直接修改类方法会作为自定义矩阵保留，直到变换参数再次改变。 */
+	get matrix() {
+		return this._matrix;
+	}
+	/** @param value 新本地矩阵 */
+	set matrix(value) {
+		if (this._matrix === value) return;
+		this._matrix.delete(this, "matrix");
+		this._matrix = value;
+		value.add(this, "matrix");
+		this.onMathChange(value, "matrix");
+	}
+	/** 世界矩阵，Mat3 通知用于更新 Mesh 连续矩阵数组。 */
+	get worldMatrix() {
+		return this._worldMatrix;
+	}
+	/** @param value 新世界矩阵 */
+	set worldMatrix(value) {
+		if (this._worldMatrix === value) return;
+		this._worldMatrix.delete(this, "worldMatrix");
+		this._worldMatrix = value;
+		value.add(this, "worldMatrix");
+		this.onMathChange(value, "worldMatrix");
+	}
+	/**
+	* 数学对象完成修改后通知节点；内部计算不反向增加输入版本。
+	* @param source 数学对象
+	* @param field position/scale/matrix/worldMatrix 关联字段
+	*/
+	onMathChange(source, field) {
+		if (this._nodeDisposed || this._writingMatrices) return;
+		if (field === "position" && source === this._position || field === "scale" && source === this._scale) this.updateVersion();
+		else if (field === "matrix" && source === this._matrix || field === "worldMatrix" && source === this._worldMatrix) {
+			this.updateVersion();
+			this._localSnapshot = this.version;
+			if (field === "worldMatrix") {
+				this._worldSnapshot = this.version;
+				this._parentSnapshot = this.parent?.worldMatrix ?? null;
+				this._parentVersion = this._parentSnapshot?.version ?? -1;
+			}
+		}
+	}
+	/** 参数版本改变后才生成本地矩阵。 */
+	ensureMatrix() {
+		if (this._nodeDisposed) throw new Error("Disposed node cannot be updated.");
+		if (this._localSnapshot !== this.version) this.updateMatrix();
+		return this._matrix;
+	}
+	/** 强制根据 position/rotation/scale 生成本地矩阵；覆盖手动指定的本地矩阵。 */
+	updateMatrix() {
+		const cos = Math.cos(this.rotation);
+		const sin = Math.sin(this.rotation);
+		this._writingMatrices = true;
+		try {
+			this._matrix.set([
+				cos * this.scale.x,
+				sin * this.scale.x,
+				0,
+				-sin * this.scale.y,
+				cos * this.scale.y,
+				0,
+				this.position.x,
+				this.position.y,
+				1
+			]);
+			this._localSnapshot = this.version;
+			this._worldSnapshot = -1;
+		} finally {
+			this._writingMatrices = false;
+		}
+		return this._matrix;
+	}
+	/** 先更新祖先，再按自身版本、父矩阵身份和版本更新世界矩阵，不遍历兄弟节点。 */
+	ensureWorldMatrix() {
+		this.parent?.ensureWorldMatrix();
+		this.ensureMatrix();
+		const parentMatrix = this.parent?.worldMatrix ?? null;
+		const parentVersion = parentMatrix?.version ?? -1;
+		if (this._worldSnapshot !== this.version || this._parentSnapshot !== parentMatrix || this._parentVersion !== parentVersion) {
+			this._writingMatrices = true;
+			try {
+				if (parentMatrix === null) this._worldMatrix.copy(this._matrix);
+				else this._worldMatrix.mul(parentMatrix, this._matrix);
+				this._worldSnapshot = this.version;
+				this._parentSnapshot = parentMatrix;
+				this._parentVersion = parentVersion;
+			} finally {
+				this._writingMatrices = false;
+			}
+		}
+		return this._worldMatrix;
+	}
+	/** 强制重新计算当前世界矩阵，同时保留显式修改的本地矩阵。 */
+	updateWorldMatrix() {
+		this._worldSnapshot = -1;
+		return this.ensureWorldMatrix();
+	}
+	/** 绘制排序值。 */
+	get order() {
+		return this._order;
+	}
+	/** @param value 新排序值；所属 Scene 递增版本，下一帧重排列表 */
+	set order(value) {
+		if (this._order === value) return;
+		this._order = value;
+		let current = this.parent;
+		while (current !== null) {
+			if (current.type === "Scene") {
+				current.updateVersion();
+				break;
+			}
+			current = current.parent;
+		}
+	}
+	/** 最终释放数学对象订阅，不移除场景节点，不销毁共享 Vec2/Mat3。 */
+	dispose() {
+		this._position.delete(this, "position");
+		this._scale.delete(this, "scale");
+		this._matrix.delete(this, "matrix");
+		this._worldMatrix.delete(this, "worldMatrix");
+		this._nodeDisposed = true;
+	}
+};
+//#endregion
+export { ObjectNode as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Object/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Object/index.ts"],"sourcesContent":["import { Vec2 } from \"bpmatrixjs/Math/Vec2\";\nimport { Mat3 } from \"bpmatrixjs/Math/Mat3\";\nimport type { MathSubscriber, VersionedMath } from \"bpmatrixjs/Math\";\nimport { GETID } from \"../ID\";\nimport type { AddObject } from \"../global-types\";\n\ninterface ObjectNodeLike extends MathSubscriber {\n    readonly id: number;\n    readonly type: string;\n    readonly version: number;\n    parent: AddObject | null;\n    position: Vec2;\n    rotation: number;\n    scale: Vec2;\n    matrix: Mat3;\n    worldMatrix: Mat3;\n    order: number;\n    updateVersion(): void;\n    ensureMatrix(): Mat3;\n    ensureWorldMatrix(): Mat3;\n    updateMatrix(): Mat3;\n    updateWorldMatrix(): Mat3;\n    dispose(): void;\n}\n\n/** 场景节点变换基类：参数持有一个版本，计算结果和每个消费者各存处理快照。 */\nclass ObjectNode implements ObjectNodeLike {\n    /** 全局节点 ID。 */\n    public readonly id: number = GETID();\n    /** 节点类型。 */\n    public readonly type: string = \"ObjectNode\";\n    private _version: number = 0;\n    private _parent: AddObject | null = null;\n    private _position: Vec2;\n    private _rotation: number = 0;\n    private _scale: Vec2;\n    private _matrix: Mat3 = new Mat3();\n    private _worldMatrix: Mat3 = new Mat3();\n    private _order: number = 0;\n    private _localSnapshot: number = -1;\n    private _worldSnapshot: number = -1;\n    private _parentSnapshot: Mat3 | null = null;\n    private _parentVersion: number = -1;\n    // 内部计算仍会通知 Mesh，但不能把计算结果误当作用户输入再次使自己失效。\n    private _writingMatrices: boolean = false;\n    protected _nodeDisposed: boolean = false;\n\n    /** @param x 初始 X 坐标 @param y 初始 Y 坐标 */\n    public constructor(x: number, y: number) {\n        this._position = new Vec2(x, y);\n        this._scale = new Vec2(1, 1);\n        this._position.add(this, \"position\");\n        this._scale.add(this, \"scale\");\n        this._matrix.add(this, \"matrix\");\n        this._worldMatrix.add(this, \"worldMatrix\");\n    }\n\n    /** 节点输入版本；计算快照不会清除或回退它。 */\n    public get version(): number { return this._version; }\n    /** 手动使变换失效；普通 position/scale/rotation 修改已自动通知。 */\n    public updateVersion(): void { this._version++; }\n\n    /** 父节点，场景树结构请通过 Group.add/remove 修改。 */\n    public get parent(): AddObject | null { return this._parent; }\n    /** @param value 父引用，Group 维护 children 与 Scene 列表 */\n    public set parent(value: AddObject | null) {\n        if (this._parent === value) return;\n        this._parent = value;\n        this.updateVersion();\n    }\n\n    /** 位置向量，内部 set/setX/x 赋值均能通知。 */\n    public get position(): Vec2 { return this._position; }\n    /** @param value 新位置向量，替换时解绑旧字段 */\n    public set position(value: Vec2) {\n        if (this._position === value) return;\n        this._position.delete(this, \"position\");\n        this._position = value;\n        value.add(this, \"position\");\n        this.updateVersion();\n    }\n\n    /** 本地旋转弧度。 */\n    public get rotation(): number { return this._rotation; }\n    /** @param value 新旋转弧度 */\n    public set rotation(value: number) {\n        if (this._rotation === value) return;\n        this._rotation = value;\n        this.updateVersion();\n    }\n\n    /** 缩放向量，可与其他节点共享。 */\n    public get scale(): Vec2 { return this._scale; }\n    /** @param value 新缩放向量 */\n    public set scale(value: Vec2) {\n        if (this._scale === value) return;\n        this._scale.delete(this, \"scale\");\n        this._scale = value;\n        value.add(this, \"scale\");\n        this.updateVersion();\n    }\n\n    /** 本地矩阵；直接修改类方法会作为自定义矩阵保留，直到变换参数再次改变。 */\n    public get matrix(): Mat3 { return this._matrix; }\n    /** @param value 新本地矩阵 */\n    public set matrix(value: Mat3) {\n        if (this._matrix === value) return;\n        this._matrix.delete(this, \"matrix\");\n        this._matrix = value;\n        value.add(this, \"matrix\");\n        this.onMathChange(value, \"matrix\");\n    }\n\n    /** 世界矩阵，Mat3 通知用于更新 Mesh 连续矩阵数组。 */\n    public get worldMatrix(): Mat3 { return this._worldMatrix; }\n    /** @param value 新世界矩阵 */\n    public set worldMatrix(value: Mat3) {\n        if (this._worldMatrix === value) return;\n        this._worldMatrix.delete(this, \"worldMatrix\");\n        this._worldMatrix = value;\n        value.add(this, \"worldMatrix\");\n        this.onMathChange(value, \"worldMatrix\");\n    }\n\n    /**\n     * 数学对象完成修改后通知节点；内部计算不反向增加输入版本。\n     * @param source 数学对象\n     * @param field position/scale/matrix/worldMatrix 关联字段\n     */\n    public onMathChange(source: VersionedMath, field: string): void {\n        if (this._nodeDisposed || this._writingMatrices) return;\n        if ((field === \"position\" && source === this._position)\n            || (field === \"scale\" && source === this._scale)) {\n            this.updateVersion();\n        } else if ((field === \"matrix\" && source === this._matrix)\n            || (field === \"worldMatrix\" && source === this._worldMatrix)) {\n            this.updateVersion();\n            this._localSnapshot = this.version;\n            if (field === \"worldMatrix\") {\n                this._worldSnapshot = this.version;\n                this._parentSnapshot = this.parent?.worldMatrix ?? null;\n                this._parentVersion = this._parentSnapshot?.version ?? -1;\n            }\n        }\n    }\n\n    /** 参数版本改变后才生成本地矩阵。 */\n    public ensureMatrix(): Mat3 {\n        if (this._nodeDisposed) throw new Error(\"Disposed node cannot be updated.\");\n        if (this._localSnapshot !== this.version) this.updateMatrix();\n        return this._matrix;\n    }\n\n    /** 强制根据 position/rotation/scale 生成本地矩阵；覆盖手动指定的本地矩阵。 */\n    public updateMatrix(): Mat3 {\n        const cos: number = Math.cos(this.rotation);\n        const sin: number = Math.sin(this.rotation);\n        this._writingMatrices = true;\n        try {\n            this._matrix.set([\n                cos * this.scale.x, sin * this.scale.x, 0,\n                -sin * this.scale.y, cos * this.scale.y, 0,\n                this.position.x, this.position.y, 1,\n            ]);\n            this._localSnapshot = this.version;\n            this._worldSnapshot = -1;\n        } finally {\n            this._writingMatrices = false;\n        }\n        return this._matrix;\n    }\n\n    /** 先更新祖先，再按自身版本、父矩阵身份和版本更新世界矩阵，不遍历兄弟节点。 */\n    public ensureWorldMatrix(): Mat3 {\n        this.parent?.ensureWorldMatrix();\n        this.ensureMatrix();\n        const parentMatrix: Mat3 | null = this.parent?.worldMatrix ?? null;\n        const parentVersion: number = parentMatrix?.version ?? -1;\n        if (this._worldSnapshot !== this.version || this._parentSnapshot !== parentMatrix\n            || this._parentVersion !== parentVersion) {\n            this._writingMatrices = true;\n            try {\n                if (parentMatrix === null) this._worldMatrix.copy(this._matrix);\n                else this._worldMatrix.mul(parentMatrix, this._matrix);\n                this._worldSnapshot = this.version;\n                this._parentSnapshot = parentMatrix;\n                this._parentVersion = parentVersion;\n            } finally {\n                this._writingMatrices = false;\n            }\n        }\n        return this._worldMatrix;\n    }\n\n    /** 强制重新计算当前世界矩阵，同时保留显式修改的本地矩阵。 */\n    public updateWorldMatrix(): Mat3 {\n        this._worldSnapshot = -1;\n        return this.ensureWorldMatrix();\n    }\n\n    /** 绘制排序值。 */\n    public get order(): number { return this._order; }\n    /** @param value 新排序值；所属 Scene 递增版本，下一帧重排列表 */\n    public set order(value: number) {\n        if (this._order === value) return;\n        this._order = value;\n        let current: AddObject | null = this.parent;\n        while (current !== null) {\n            if (current.type === \"Scene\") {\n                current.updateVersion();\n                break;\n            }\n            current = current.parent;\n        }\n    }\n\n    /** 最终释放数学对象订阅，不移除场景节点，不销毁共享 Vec2/Mat3。 */\n    public dispose(): void {\n        this._position.delete(this, \"position\");\n        this._scale.delete(this, \"scale\");\n        this._matrix.delete(this, \"matrix\");\n        this._worldMatrix.delete(this, \"worldMatrix\");\n        this._nodeDisposed = true;\n    }\n}\nexport default ObjectNode;\nexport type { ObjectNodeLike };\n"],"mappings":";;;;;AA0BA,IAAM,aAAN,MAA2C;;CAEvC,KAA6B,MAAM;;CAEnC,OAA+B;CAC/B,WAA2B;CAC3B,UAAoC;CACpC;CACA,YAA4B;CAC5B;CACA,UAAwB,IAAI,KAAK;CACjC,eAA6B,IAAI,KAAK;CACtC,SAAyB;CACzB,iBAAiC;CACjC,iBAAiC;CACjC,kBAAuC;CACvC,iBAAiC;CAEjC,mBAAoC;CACpC,gBAAmC;;CAGnC,YAAmB,GAAW,GAAW;EACrC,KAAK,YAAY,IAAI,KAAK,GAAG,CAAC;EAC9B,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC;EAC3B,KAAK,UAAU,IAAI,MAAM,UAAU;EACnC,KAAK,OAAO,IAAI,MAAM,OAAO;EAC7B,KAAK,QAAQ,IAAI,MAAM,QAAQ;EAC/B,KAAK,aAAa,IAAI,MAAM,aAAa;CAC7C;;CAGA,IAAW,UAAkB;EAAE,OAAO,KAAK;CAAU;;CAErD,gBAA6B;EAAE,KAAK;CAAY;;CAGhD,IAAW,SAA2B;EAAE,OAAO,KAAK;CAAS;;CAE7D,IAAW,OAAO,OAAyB;EACvC,IAAI,KAAK,YAAY,OAAO;EAC5B,KAAK,UAAU;EACf,KAAK,cAAc;CACvB;;CAGA,IAAW,WAAiB;EAAE,OAAO,KAAK;CAAW;;CAErD,IAAW,SAAS,OAAa;EAC7B,IAAI,KAAK,cAAc,OAAO;EAC9B,KAAK,UAAU,OAAO,MAAM,UAAU;EACtC,KAAK,YAAY;EACjB,MAAM,IAAI,MAAM,UAAU;EAC1B,KAAK,cAAc;CACvB;;CAGA,IAAW,WAAmB;EAAE,OAAO,KAAK;CAAW;;CAEvD,IAAW,SAAS,OAAe;EAC/B,IAAI,KAAK,cAAc,OAAO;EAC9B,KAAK,YAAY;EACjB,KAAK,cAAc;CACvB;;CAGA,IAAW,QAAc;EAAE,OAAO,KAAK;CAAQ;;CAE/C,IAAW,MAAM,OAAa;EAC1B,IAAI,KAAK,WAAW,OAAO;EAC3B,KAAK,OAAO,OAAO,MAAM,OAAO;EAChC,KAAK,SAAS;EACd,MAAM,IAAI,MAAM,OAAO;EACvB,KAAK,cAAc;CACvB;;CAGA,IAAW,SAAe;EAAE,OAAO,KAAK;CAAS;;CAEjD,IAAW,OAAO,OAAa;EAC3B,IAAI,KAAK,YAAY,OAAO;EAC5B,KAAK,QAAQ,OAAO,MAAM,QAAQ;EAClC,KAAK,UAAU;EACf,MAAM,IAAI,MAAM,QAAQ;EACxB,KAAK,aAAa,OAAO,QAAQ;CACrC;;CAGA,IAAW,cAAoB;EAAE,OAAO,KAAK;CAAc;;CAE3D,IAAW,YAAY,OAAa;EAChC,IAAI,KAAK,iBAAiB,OAAO;EACjC,KAAK,aAAa,OAAO,MAAM,aAAa;EAC5C,KAAK,eAAe;EACpB,MAAM,IAAI,MAAM,aAAa;EAC7B,KAAK,aAAa,OAAO,aAAa;CAC1C;;;;;;CAOA,aAAoB,QAAuB,OAAqB;EAC5D,IAAI,KAAK,iBAAiB,KAAK,kBAAkB;EACjD,IAAK,UAAU,cAAc,WAAW,KAAK,aACrC,UAAU,WAAW,WAAW,KAAK,QACzC,KAAK,cAAc;OAChB,IAAK,UAAU,YAAY,WAAW,KAAK,WAC1C,UAAU,iBAAiB,WAAW,KAAK,cAAe;GAC9D,KAAK,cAAc;GACnB,KAAK,iBAAiB,KAAK;GAC3B,IAAI,UAAU,eAAe;IACzB,KAAK,iBAAiB,KAAK;IAC3B,KAAK,kBAAkB,KAAK,QAAQ,eAAe;IACnD,KAAK,iBAAiB,KAAK,iBAAiB,WAAW;GAC3D;EACJ;CACJ;;CAGA,eAA4B;EACxB,IAAI,KAAK,eAAe,MAAM,IAAI,MAAM,kCAAkC;EAC1E,IAAI,KAAK,mBAAmB,KAAK,SAAS,KAAK,aAAa;EAC5D,OAAO,KAAK;CAChB;;CAGA,eAA4B;EACxB,MAAM,MAAc,KAAK,IAAI,KAAK,QAAQ;EAC1C,MAAM,MAAc,KAAK,IAAI,KAAK,QAAQ;EAC1C,KAAK,mBAAmB;EACxB,IAAI;GACA,KAAK,QAAQ,IAAI;IACb,MAAM,KAAK,MAAM;IAAG,MAAM,KAAK,MAAM;IAAG;IACxC,CAAC,MAAM,KAAK,MAAM;IAAG,MAAM,KAAK,MAAM;IAAG;IACzC,KAAK,SAAS;IAAG,KAAK,SAAS;IAAG;GACtC,CAAC;GACD,KAAK,iBAAiB,KAAK;GAC3B,KAAK,iBAAiB;EAC1B,UAAU;GACN,KAAK,mBAAmB;EAC5B;EACA,OAAO,KAAK;CAChB;;CAGA,oBAAiC;EAC7B,KAAK,QAAQ,kBAAkB;EAC/B,KAAK,aAAa;EAClB,MAAM,eAA4B,KAAK,QAAQ,eAAe;EAC9D,MAAM,gBAAwB,cAAc,WAAW;EACvD,IAAI,KAAK,mBAAmB,KAAK,WAAW,KAAK,oBAAoB,gBAC9D,KAAK,mBAAmB,eAAe;GAC1C,KAAK,mBAAmB;GACxB,IAAI;IACA,IAAI,iBAAiB,MAAM,KAAK,aAAa,KAAK,KAAK,OAAO;SACzD,KAAK,aAAa,IAAI,cAAc,KAAK,OAAO;IACrD,KAAK,iBAAiB,KAAK;IAC3B,KAAK,kBAAkB;IACvB,KAAK,iBAAiB;GAC1B,UAAU;IACN,KAAK,mBAAmB;GAC5B;EACJ;EACA,OAAO,KAAK;CAChB;;CAGA,oBAAiC;EAC7B,KAAK,iBAAiB;EACtB,OAAO,KAAK,kBAAkB;CAClC;;CAGA,IAAW,QAAgB;EAAE,OAAO,KAAK;CAAQ;;CAEjD,IAAW,MAAM,OAAe;EAC5B,IAAI,KAAK,WAAW,OAAO;EAC3B,KAAK,SAAS;EACd,IAAI,UAA4B,KAAK;EACrC,OAAO,YAAY,MAAM;GACrB,IAAI,QAAQ,SAAS,SAAS;IAC1B,QAAQ,cAAc;IACtB;GACJ;GACA,UAAU,QAAQ;EACtB;CACJ;;CAGA,UAAuB;EACnB,KAAK,UAAU,OAAO,MAAM,UAAU;EACtC,KAAK,OAAO,OAAO,MAAM,OAAO;EAChC,KAAK,QAAQ,OAAO,MAAM,QAAQ;EAClC,KAAK,aAAa,OAAO,MAAM,aAAa;EAC5C,KAAK,gBAAgB;CACzB;AACJ"}

package/lib/Raws/index.d.ts

@@ -0,0 +1,87 @@
+import { Vec2 } from "bpmatrixjs/Math";
+import type { MathSubscriber, VersionedMath } from "bpmatrixjs/Math";
+import Style from "../Style";
+import type { StyleChange, StyleSubscriber } from "../Style";
+/** push / updateAt 使用的完整快照；省略项分别为原点、0、单位缩放和默认样式。 */
+export interface RawOptions {
+    position?: Vec2;
+    rotation?: number;
+    scale?: Vec2;
+    style?: Style;
+    enabled?: boolean;
+}
+/** 原始值变化的影响范围，版本仍只有 Raw.version 一个。 */
+export type RawChange = "matrix" | "style" | "texture" | "textureData" | "sampler";
+/** 原始值管理者，不在回调内分配 GPU 资源。 */
+export interface RawSubscriber {
+    onRawChange(raw: Raw, change: RawChange): void;
+}
+/** 一条实例原始记录；id 稳定，index 对应连续数组中的槽位。 */
+export declare class Raw implements MathSubscriber, StyleSubscriber {
+    /** 全局唯一 ID，不随扩容改变。 */
+    readonly id: number;
+    /** 连续数组槽位，不是字节偏移。 */
+    readonly index: number;
+    private _position;
+    private _rotation;
+    private _scale;
+    private _style;
+    private _enabled;
+    private _version;
+    private readonly _subscribers;
+    private _disposed;
+    /**
+     * @param index 槽位
+     * @param options 原始值，不复制 Vec2 / Style，允许共享并接收通知
+     */
+    constructor(index: number, options?: RawOptions);
+    /** 任意原始值变化时递增；打包或扩容不会改变这个版本。 */
+    get version(): number;
+    /** 相对于 IMesh 的位置。 */
+    get position(): Vec2;
+    /** @param value 位置引用，旧引用解除关联 */
+    set position(value: Vec2);
+    /** 局部旋转弧度。 */
+    get rotation(): number;
+    /** @param value 有限弧度 */
+    set rotation(value: number);
+    /** 局部缩放。 */
+    get scale(): Vec2;
+    /** @param value 缩放引用 */
+    set scale(value: Vec2);
+    /** 本条记录的独立样式，不覆盖共享 Geometry / Material.style。 */
+    get style(): Style;
+    /** @param value 新样式引用 */
+    set style(value: Style);
+    /** 是否绘制此槽位；关闭不删除记录或移动其他 index。 */
+    get enabled(): boolean;
+    /** @param value 是否绘制 */
+    set enabled(value: boolean);
+    /** @param subscriber 接收下一帧更新通知的管理者 */
+    add(subscriber: RawSubscriber): void;
+    /** @param subscriber 解除关联的管理者 */
+    delete(subscriber: RawSubscriber): void;
+    /** @param source 数学对象 @param field 关联字段 */
+    onMathChange(source: VersionedMath, field: string): void;
+    /** @param change 样式变化，图片像素变化不重打包数值 */
+    onStyleChange(change: StyleChange): void;
+    /** 解绑原始对象；不销毁共享 Vec2、Style 或 Texture。 */
+    dispose(): void;
+    /** 防止已解绑的记录重新产生部分关联。 */
+    private assertActive;
+    /** @param change 本次需要重新打包的区域 */
+    private notify;
+}
+/** 由 IMesh 持有的原始记录索引；外部使用 map.get(id) 后修改记录，不直接增删 Map。 */
+declare class Raws {
+    private readonly _map;
+    /** 只读 Map，避免外部删除记录后遗留订阅或数组空洞。 */
+    get map(): ReadonlyMap<number, Raw>;
+    /** 记录数量，raw=false 时始终为 0。 */
+    get size(): number;
+    /** @param raw 由 IMesh 创建的记录 @internal */
+    add(raw: Raw): void;
+    /** 由 IMesh.clear / dispose 调用，解除全部订阅。 @internal */
+    clear(): void;
+}
+export default Raws;

package/lib/Raws/index.js

@@ -0,0 +1,164 @@
+import { GETID } from "../ID.js";
+import Style from "../Style/index.js";
+import { Vec2 } from "bpmatrixjs/Math";
+//#region src/scripts/Raws/index.ts
+/** 一条实例原始记录；id 稳定，index 对应连续数组中的槽位。 */
+var Raw = class {
+	/** 全局唯一 ID，不随扩容改变。 */
+	id = GETID();
+	/** 连续数组槽位，不是字节偏移。 */
+	index;
+	_position;
+	_rotation;
+	_scale;
+	_style;
+	_enabled;
+	_version = 0;
+	_subscribers = /* @__PURE__ */ new Set();
+	_disposed = false;
+	/**
+	* @param index 槽位
+	* @param options 原始值，不复制 Vec2 / Style，允许共享并接收通知
+	*/
+	constructor(index, options = {}) {
+		if (!Number.isSafeInteger(index) || index < 0) throw new RangeError("Invalid raw index.");
+		this.index = index;
+		this._position = options.position ?? new Vec2();
+		this._rotation = options.rotation ?? 0;
+		this._scale = options.scale ?? new Vec2(1, 1);
+		this._style = options.style ?? new Style();
+		this._enabled = options.enabled ?? true;
+		if (!Number.isFinite(this._rotation)) throw new RangeError("Rotation must be finite.");
+		this._position.add(this, "position");
+		this._scale.add(this, "scale");
+		this._style.add(this);
+	}
+	/** 任意原始值变化时递增；打包或扩容不会改变这个版本。 */
+	get version() {
+		return this._version;
+	}
+	/** 相对于 IMesh 的位置。 */
+	get position() {
+		return this._position;
+	}
+	/** @param value 位置引用，旧引用解除关联 */
+	set position(value) {
+		if (value === this._position) return;
+		this.assertActive();
+		this._position.delete(this, "position");
+		this._position = value;
+		value.add(this, "position");
+		this.notify("matrix");
+	}
+	/** 局部旋转弧度。 */
+	get rotation() {
+		return this._rotation;
+	}
+	/** @param value 有限弧度 */
+	set rotation(value) {
+		if (!Number.isFinite(value)) throw new RangeError("Rotation must be finite.");
+		if (value === this._rotation) return;
+		this.assertActive();
+		this._rotation = value;
+		this.notify("matrix");
+	}
+	/** 局部缩放。 */
+	get scale() {
+		return this._scale;
+	}
+	/** @param value 缩放引用 */
+	set scale(value) {
+		if (value === this._scale) return;
+		this.assertActive();
+		this._scale.delete(this, "scale");
+		this._scale = value;
+		value.add(this, "scale");
+		this.notify("matrix");
+	}
+	/** 本条记录的独立样式，不覆盖共享 Geometry / Material.style。 */
+	get style() {
+		return this._style;
+	}
+	/** @param value 新样式引用 */
+	set style(value) {
+		if (value === this._style) return;
+		this.assertActive();
+		this._style.delete(this);
+		this._style = value;
+		value.add(this);
+		this.notify("texture");
+	}
+	/** 是否绘制此槽位；关闭不删除记录或移动其他 index。 */
+	get enabled() {
+		return this._enabled;
+	}
+	/** @param value 是否绘制 */
+	set enabled(value) {
+		if (value === this._enabled) return;
+		this.assertActive();
+		this._enabled = value;
+		this.notify("style");
+	}
+	/** @param subscriber 接收下一帧更新通知的管理者 */
+	add(subscriber) {
+		this.assertActive();
+		this._subscribers.add(subscriber);
+	}
+	/** @param subscriber 解除关联的管理者 */
+	delete(subscriber) {
+		this._subscribers.delete(subscriber);
+	}
+	/** @param source 数学对象 @param field 关联字段 */
+	onMathChange(source, field) {
+		if (field === "position" && source === this._position || field === "scale" && source === this._scale) this.notify("matrix");
+	}
+	/** @param change 样式变化，图片像素变化不重打包数值 */
+	onStyleChange(change) {
+		if (change.source !== this._style) return;
+		const field = change.field;
+		this.notify(field === "texture" ? "texture" : field === "textureData" ? "textureData" : field === "addressModeU" || field === "addressModeV" ? "sampler" : "style");
+	}
+	/** 解绑原始对象；不销毁共享 Vec2、Style 或 Texture。 */
+	dispose() {
+		this._position.delete(this, "position");
+		this._scale.delete(this, "scale");
+		this._style.delete(this);
+		this._subscribers.clear();
+		this._disposed = true;
+	}
+	/** 防止已解绑的记录重新产生部分关联。 */
+	assertActive() {
+		if (this._disposed) throw new Error("Disposed Raw cannot be reused.");
+	}
+	/** @param change 本次需要重新打包的区域 */
+	notify(change) {
+		if (this._disposed) return;
+		this._version++;
+		for (const subscriber of this._subscribers) subscriber.onRawChange(this, change);
+	}
+};
+/** 由 IMesh 持有的原始记录索引；外部使用 map.get(id) 后修改记录，不直接增删 Map。 */
+var Raws = class {
+	_map = /* @__PURE__ */ new Map();
+	/** 只读 Map，避免外部删除记录后遗留订阅或数组空洞。 */
+	get map() {
+		return this._map;
+	}
+	/** 记录数量，raw=false 时始终为 0。 */
+	get size() {
+		return this._map.size;
+	}
+	/** @param raw 由 IMesh 创建的记录 @internal */
+	add(raw) {
+		this._map.set(raw.id, raw);
+	}
+	/** 由 IMesh.clear / dispose 调用，解除全部订阅。 @internal */
+	clear() {
+		for (const raw of this._map.values()) raw.dispose();
+		this._map.clear();
+	}
+};
+//#endregion
+export { Raw, Raws as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Raws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Raws/index.ts"],"sourcesContent":["import { Vec2 } from \"bpmatrixjs/Math\";\nimport type { MathSubscriber, VersionedMath } from \"bpmatrixjs/Math\";\nimport { GETID } from \"../ID\";\nimport Style from \"../Style\";\nimport type { StyleChange, StyleSubscriber } from \"../Style\";\n\n/** push / updateAt 使用的完整快照；省略项分别为原点、0、单位缩放和默认样式。 */\nexport interface RawOptions {\n    position?: Vec2;\n    rotation?: number;\n    scale?: Vec2;\n    style?: Style;\n    enabled?: boolean;\n}\n\n/** 原始值变化的影响范围，版本仍只有 Raw.version 一个。 */\nexport type RawChange = \"matrix\" | \"style\" | \"texture\" | \"textureData\" | \"sampler\";\n\n/** 原始值管理者，不在回调内分配 GPU 资源。 */\nexport interface RawSubscriber {\n    onRawChange(raw: Raw, change: RawChange): void;\n}\n\n/** 一条实例原始记录；id 稳定，index 对应连续数组中的槽位。 */\nexport class Raw implements MathSubscriber, StyleSubscriber {\n    /** 全局唯一 ID，不随扩容改变。 */\n    public readonly id: number = GETID();\n    /** 连续数组槽位，不是字节偏移。 */\n    public readonly index: number;\n    private _position: Vec2;\n    private _rotation: number;\n    private _scale: Vec2;\n    private _style: Style;\n    private _enabled: boolean;\n    private _version: number = 0;\n    private readonly _subscribers = new Set<RawSubscriber>();\n    private _disposed: boolean = false;\n\n    /**\n     * @param index 槽位\n     * @param options 原始值，不复制 Vec2 / Style，允许共享并接收通知\n     */\n    public constructor(index: number, options: RawOptions = {}) {\n        if (!Number.isSafeInteger(index) || index < 0) throw new RangeError(\"Invalid raw index.\");\n        this.index = index;\n        this._position = options.position ?? new Vec2();\n        this._rotation = options.rotation ?? 0;\n        this._scale = options.scale ?? new Vec2(1, 1);\n        this._style = options.style ?? new Style();\n        this._enabled = options.enabled ?? true;\n        if (!Number.isFinite(this._rotation)) throw new RangeError(\"Rotation must be finite.\");\n        this._position.add(this, \"position\");\n        this._scale.add(this, \"scale\");\n        this._style.add(this);\n    }\n\n    /** 任意原始值变化时递增；打包或扩容不会改变这个版本。 */\n    public get version(): number { return this._version; }\n    /** 相对于 IMesh 的位置。 */\n    public get position(): Vec2 { return this._position; }\n    /** @param value 位置引用，旧引用解除关联 */\n    public set position(value: Vec2) {\n        if (value === this._position) return;\n        this.assertActive();\n        this._position.delete(this, \"position\");\n        this._position = value;\n        value.add(this, \"position\");\n        this.notify(\"matrix\");\n    }\n    /** 局部旋转弧度。 */\n    public get rotation(): number { return this._rotation; }\n    /** @param value 有限弧度 */\n    public set rotation(value: number) {\n        if (!Number.isFinite(value)) throw new RangeError(\"Rotation must be finite.\");\n        if (value === this._rotation) return;\n        this.assertActive();\n        this._rotation = value;\n        this.notify(\"matrix\");\n    }\n    /** 局部缩放。 */\n    public get scale(): Vec2 { return this._scale; }\n    /** @param value 缩放引用 */\n    public set scale(value: Vec2) {\n        if (value === this._scale) return;\n        this.assertActive();\n        this._scale.delete(this, \"scale\");\n        this._scale = value;\n        value.add(this, \"scale\");\n        this.notify(\"matrix\");\n    }\n    /** 本条记录的独立样式，不覆盖共享 Geometry / Material.style。 */\n    public get style(): Style { return this._style; }\n    /** @param value 新样式引用 */\n    public set style(value: Style) {\n        if (value === this._style) return;\n        this.assertActive();\n        this._style.delete(this);\n        this._style = value;\n        value.add(this);\n        this.notify(\"texture\");\n    }\n    /** 是否绘制此槽位；关闭不删除记录或移动其他 index。 */\n    public get enabled(): boolean { return this._enabled; }\n    /** @param value 是否绘制 */\n    public set enabled(value: boolean) {\n        if (value === this._enabled) return;\n        this.assertActive();\n        this._enabled = value;\n        this.notify(\"style\");\n    }\n    /** @param subscriber 接收下一帧更新通知的管理者 */\n    public add(subscriber: RawSubscriber): void { this.assertActive(); this._subscribers.add(subscriber); }\n    /** @param subscriber 解除关联的管理者 */\n    public delete(subscriber: RawSubscriber): void { this._subscribers.delete(subscriber); }\n    /** @param source 数学对象 @param field 关联字段 */\n    public onMathChange(source: VersionedMath, field: string): void {\n        if ((field === \"position\" && source === this._position) || (field === \"scale\" && source === this._scale)) this.notify(\"matrix\");\n    }\n    /** @param change 样式变化，图片像素变化不重打包数值 */\n    public onStyleChange(change: StyleChange): void {\n        if (change.source !== this._style) return;\n        const field = change.field;\n        this.notify(field === \"texture\" ? \"texture\" : field === \"textureData\" ? \"textureData\"\n            : field === \"addressModeU\" || field === \"addressModeV\" ? \"sampler\" : \"style\");\n    }\n    /** 解绑原始对象；不销毁共享 Vec2、Style 或 Texture。 */\n    public dispose(): void {\n        this._position.delete(this, \"position\");\n        this._scale.delete(this, \"scale\");\n        this._style.delete(this);\n        this._subscribers.clear();\n        this._disposed = true;\n    }\n    /** 防止已解绑的记录重新产生部分关联。 */\n    private assertActive(): void {\n        if (this._disposed) throw new Error(\"Disposed Raw cannot be reused.\");\n    }\n    /** @param change 本次需要重新打包的区域 */\n    private notify(change: RawChange): void {\n        if (this._disposed) return;\n        this._version++;\n        for (const subscriber of this._subscribers) subscriber.onRawChange(this, change);\n    }\n}\n\n/** 由 IMesh 持有的原始记录索引；外部使用 map.get(id) 后修改记录，不直接增删 Map。 */\nclass Raws {\n    private readonly _map = new Map<number, Raw>();\n    /** 只读 Map，避免外部删除记录后遗留订阅或数组空洞。 */\n    public get map(): ReadonlyMap<number, Raw> { return this._map; }\n    /** 记录数量，raw=false 时始终为 0。 */\n    public get size(): number { return this._map.size; }\n    /** @param raw 由 IMesh 创建的记录 @internal */\n    public add(raw: Raw): void { this._map.set(raw.id, raw); }\n    /** 由 IMesh.clear / dispose 调用，解除全部订阅。 @internal */\n    public clear(): void {\n        for (const raw of this._map.values()) raw.dispose();\n        this._map.clear();\n    }\n}\n\nexport default Raws;\n"],"mappings":"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"}

package/lib/Render/BufferManager.d.ts

@@ -0,0 +1,93 @@
+import type Camera from "../Camera";
+import type Scene from "../Scene";
+import type { PipelineLike, RenderMode } from "./types";
+interface BufferManagerLike {
+    draw(scene: Scene, camera: Camera, dpr: number, renderMode: RenderMode): void;
+}
+/**
+ * 管理当前 Render 对应的 Camera、Material、Mesh 和 Geometry GPUBuffer。
+ * @class
+ */
+declare class BufferManager implements BufferManagerLike {
+    private readonly pipeline;
+    private readonly depthManager;
+    private readonly developmentValidator;
+    private _cameraSnapshot;
+    private readonly _validatedMaterials;
+    /**
+     * 创建缓冲管理器。
+     * @param pipeline 当前 Render 的共享管线资源
+     */
+    constructor(pipeline: PipelineLike);
+    /**
+     * 创建或更新当前场景需要的 GPUBuffer。
+     * @param scene 场景对象
+     * @param camera 相机对象
+     * @param dpr 当前设备像素比
+     * @param renderMode 当前 Render 运行模式
+     * @returns 无返回值
+     */
+    draw(scene: Scene, camera: Camera, dpr: number, renderMode: RenderMode): void;
+    /**
+     * 按 materialList 检查材质，共享材质每个版本只检查一次。
+     * 材质显示数值的 GPU 存储属于 Mesh 实例数组，不在这里重复创建一份缓冲。
+     * @param scene 场景对象
+     * @param renderMode production 跳过开发检查
+     */
+    private prepareMaterials;
+    /**
+     * 创建并写入基础 GPUBuffer。
+     * @param device 当前 Render 对应的 WebGPU 设备
+     * @param label GPU 调试标签
+     * @param data 首次写入的缓冲数据
+     * @param usage 缓冲用途标记
+     * @returns 已写入数据的 GPUBuffer
+     */
+    private createBuffer;
+    /**
+     * 按当前 Render 自己的矩阵身份和版本快照上传相机数据。
+     * @param device WebGPU 设备
+     * @param camera 相机对象
+     * @param dpr 设备像素比
+     */
+    private drawCameraBuffers;
+    /**
+     * 创建或更新每个 Mesh 的连续矩阵与样式 Storage 数组，分别对比版本。
+     * @param device 当前 WebGPU 设备
+     * @param scene 场景对象
+     * @param renderMode 当前 Render 运行模式
+     * @returns 无返回值
+     */
+    private drawMeshBuffers;
+    /**
+     * 为去重后的 Geometry 创建顶点、二维轮廓法线、UV、索引和参数缓冲。
+     * @param device 当前 WebGPU 设备
+     * @param scene 场景对象
+     * @param renderMode 当前 Render 运行模式
+     * @returns 无返回值
+     */
+    private drawGeometryBuffers;
+    /**
+     * 创建单种几何绘制模式的顶点、二维轮廓法线、UV 和索引缓冲。
+     * @param device 当前 WebGPU 设备
+     * @param label GPU 调试标签前缀
+     * @param data CPU 几何数据
+     * @returns 已创建的几何缓冲分区
+     */
+    private createGeometryBufferPart;
+    /**
+     * 获取关键点索引段起点，缓存后绘制时无需重复遍历。
+     * 原生 line-list 需要插在实体面与关键点之间时，复用同一个合并缓冲分段绘制。
+     * @param data 已按面、边框、关键点顺序合并的数据
+     * @returns 关键点索引段起点；没有关键点时等于总索引数
+     */
+    private getPointsFirstIndex;
+    /**
+     * 销毁一个 Geometry 缓存集合中的全部已创建缓冲。
+     * @param geometryBuffer Geometry GPU 缓存集合
+     * @returns 无返回值
+     */
+    private destroyGeometryBuffer;
+}
+export default BufferManager;
+export type { BufferManagerLike };