bplinejs 0.0.101-beta.10

package/lib/Scene/index.d.ts

@@ -0,0 +1,124 @@
+import type { AddObject, Geometry2d, Material2d } from "../global-types";
+import Group from "../Group";
+import type { GroupLike } from "../Group";
+import type { MeshLike } from "../Mesh";
+import type { TextureResource } from "../Texture/Layers";
+type DrawList = MeshLike;
+type GeometryList = Geometry2d;
+type MaterialList = Material2d;
+type TextureList = TextureResource;
+interface SceneLike extends GroupLike {
+    drawList: DrawList[];
+    geometryList: GeometryList[];
+    materialList: MaterialList[];
+    textureList: TextureList[];
+    ensureLists(): DrawList[];
+    addToLists(child: AddObject): void;
+    removeFromLists(child: AddObject): void;
+    updateLists(): DrawList[];
+    updateResourceLists(): void;
+    updateDrawList(): DrawList[];
+    updateTextureList(): TextureList[];
+    getMaterialGeometryTypes(materialId: number): ReadonlySet<string>;
+    updateDrawOrder(): void;
+}
+/**
+ * 场景对象
+ * 作为场景树的根级容器使用
+ * @class
+ */
+declare class Scene extends Group implements SceneLike {
+    /**
+     * 对象类型
+     */
+    readonly type: string;
+    /** CPU 四个列表与贴图列表分别处理到的版本快照，不是额外版本源。 */
+    private _listsSnapshot;
+    private _textureSnapshot;
+    /**
+     * 当前 Scene 中材质实际搭配的几何类型，不使用材质历史类型创建闲置模板。
+     */
+    private readonly _materialGeometryTypes;
+    /**
+     * 当前绘制列表
+     */
+    drawList: DrawList[];
+    /**
+     * 当前场景使用的去重 Geometry 列表。
+     * 多个 Mesh 共用同一 Geometry 时只保留一个对象引用。
+     */
+    geometryList: GeometryList[];
+    /**
+     * 当前场景使用的去重 Material 列表。
+     * Material 对象同时提供 id 和 key，分别用于资源销毁与 Pipeline 复用。
+     */
+    materialList: MaterialList[];
+    /**
+     * 当前场景使用的去重 Texture 列表。
+     */
+    textureList: TextureList[];
+    /**
+     * 创建场景对象
+     */
+    constructor();
+    /** 版本变化后统一重建四个列表；一个 Render 处理后不影响其他 Render 的缓存快照。 */
+    ensureLists(): DrawList[];
+    /**
+     * 将新加入场景的节点及其后代增量写入四个列表。
+     * 该方法只负责补充引用；删除节点时由 removeFromLists 处理共享资源校准。
+     * @param child 新加入场景树的节点
+     * @returns 无返回值
+     */
+    addToLists(child: AddObject): void;
+    /**
+     * 从 drawList 中移除节点及其后代包含的 Mesh。
+     * 资源可能仍被其他 Mesh 共用，因此只标记下一帧重建另外三个资源列表。
+     * @param child 从场景树删除的节点
+     * @returns 无返回值
+     */
+    removeFromLists(child: AddObject): void;
+    /**
+     * 一次递归更新场景的 Mesh、Geometry、Material 和 Texture 四个列表。
+     * Geometry、Material 与 Texture 按全局 ID 去重，供 Render 创建和回收缓存。
+     * @returns 更新后的绘制列表
+     */
+    updateLists(): DrawList[];
+    /**
+     * 根据当前 drawList 重建 Geometry、Material 和 Texture 三个资源列表。
+     * 资源按全局 ID 去重，避免删除共享资源时误伤仍在场景中的 Mesh。
+     * @returns 无返回值
+     */
+    updateResourceLists(): void;
+    /**
+     * 更新绘制列表及其关联资源列表。
+     * 保留原方法名，现有调用会同步更新全部四个列表。
+     * @returns 更新后的绘制列表
+     */
+    updateDrawList(): DrawList[];
+    /**
+     * 根据材质列表单独刷新 Texture 列表。
+     * 适用于只替换 Style 中 solid、edge、points.texture 的普通渲染帧。
+     * @returns 更新后的贴图列表
+     */
+    updateTextureList(): TextureList[];
+    /**
+     * 获取当前场景中一个材质实际使用的几何类型，供 materialList 创建管线。
+     * @param materialId 材质 ID
+     * @returns 几何类型只读集合；不要修改返回的内部集合
+     */
+    getMaterialGeometryTypes(materialId: number): ReadonlySet<string>;
+    /**
+     * 记录一个实际 Mesh 的材质与几何类型组合。
+     * @param materialId 材质 ID
+     * @param geometryType 几何类型
+     */
+    private addMaterialGeometryType;
+    /**
+     * 更新场景绘制顺序。
+     * 仅按照 Mesh 的 order 从小到大重新排列 drawList，不重建其他资源列表。
+     * @returns 无返回值
+     */
+    updateDrawOrder(): void;
+}
+export default Scene;
+export type { DrawList, GeometryList, MaterialList, SceneLike, TextureList };

package/lib/Scene/index.js

@@ -0,0 +1,225 @@
+import Group from "../Group/index.js";
+import Mesh from "../Mesh/index.js";
+//#region src/scripts/Scene/index.ts
+/**
+* 场景对象
+* 作为场景树的根级容器使用
+* @class
+*/
+var Scene = class extends Group {
+	/**
+	* 对象类型
+	*/
+	type = "Scene";
+	/** CPU 四个列表与贴图列表分别处理到的版本快照，不是额外版本源。 */
+	_listsSnapshot = -1;
+	_textureSnapshot = -1;
+	/**
+	* 当前 Scene 中材质实际搭配的几何类型，不使用材质历史类型创建闲置模板。
+	*/
+	_materialGeometryTypes = /* @__PURE__ */ new Map();
+	/**
+	* 当前绘制列表
+	*/
+	drawList = [];
+	/**
+	* 当前场景使用的去重 Geometry 列表。
+	* 多个 Mesh 共用同一 Geometry 时只保留一个对象引用。
+	*/
+	geometryList = [];
+	/**
+	* 当前场景使用的去重 Material 列表。
+	* Material 对象同时提供 id 和 key，分别用于资源销毁与 Pipeline 复用。
+	*/
+	materialList = [];
+	/**
+	* 当前场景使用的去重 Texture 列表。
+	*/
+	textureList = [];
+	/**
+	* 创建场景对象
+	*/
+	constructor() {
+		super(0, 0);
+	}
+	/** 版本变化后统一重建四个列表；一个 Render 处理后不影响其他 Render 的缓存快照。 */
+	ensureLists() {
+		if (this._listsSnapshot !== this.version) this.updateLists();
+		return this.drawList;
+	}
+	/**
+	* 将新加入场景的节点及其后代增量写入四个列表。
+	* 该方法只负责补充引用；删除节点时由 removeFromLists 处理共享资源校准。
+	* @param child 新加入场景树的节点
+	* @returns 无返回值
+	*/
+	addToLists(child) {
+		const collect = (node) => {
+			if (node instanceof Mesh && node.data !== void 0 && node.material !== void 0) {
+				if (!this.drawList.some((mesh) => mesh.id === node.id)) this.drawList.push(node);
+				if (!this.geometryList.some((geometry) => geometry.id === node.data?.id)) this.geometryList.push(node.data);
+				if (!this.materialList.some((material) => material.id === node.material?.id)) this.materialList.push(node.material);
+				this.addMaterialGeometryType(node.material.id, node.data.type);
+				for (const texture of GetMeshTextures(node)) if (!this.textureList.some((item) => item.id === texture.id)) this.textureList.push(texture);
+			}
+			if (node instanceof Group) for (const nextChild of node.children) collect(nextChild);
+		};
+		collect(child);
+		this.updateDrawOrder();
+	}
+	/**
+	* 从 drawList 中移除节点及其后代包含的 Mesh。
+	* 资源可能仍被其他 Mesh 共用，因此只标记下一帧重建另外三个资源列表。
+	* @param child 从场景树删除的节点
+	* @returns 无返回值
+	*/
+	removeFromLists(child) {
+		const removedMeshIds = /* @__PURE__ */ new Set();
+		const collect = (node) => {
+			if (node instanceof Mesh) removedMeshIds.add(node.id);
+			if (node instanceof Group) for (const nextChild of node.children) collect(nextChild);
+		};
+		collect(child);
+		if (removedMeshIds.size === 0) return;
+		this.drawList = this.drawList.filter((mesh) => {
+			return !removedMeshIds.has(mesh.id);
+		});
+		this.updateVersion();
+	}
+	/**
+	* 一次递归更新场景的 Mesh、Geometry、Material 和 Texture 四个列表。
+	* Geometry、Material 与 Texture 按全局 ID 去重，供 Render 创建和回收缓存。
+	* @returns 更新后的绘制列表
+	*/
+	updateLists() {
+		this.updateVersion();
+		const drawList = [];
+		const collect = (child) => {
+			if (child instanceof Mesh && child.data !== void 0 && child.material !== void 0) drawList.push(child);
+			if (child instanceof Group) for (const nextChild of child.children) collect(nextChild);
+		};
+		for (const child of this.children) collect(child);
+		this.drawList = drawList;
+		this.updateResourceLists();
+		this.updateDrawOrder();
+		this._listsSnapshot = this.version;
+		return this.drawList;
+	}
+	/**
+	* 根据当前 drawList 重建 Geometry、Material 和 Texture 三个资源列表。
+	* 资源按全局 ID 去重，避免删除共享资源时误伤仍在场景中的 Mesh。
+	* @returns 无返回值
+	*/
+	updateResourceLists() {
+		this._materialGeometryTypes.clear();
+		const geometryList = [];
+		const materialList = [];
+		const textureList = [];
+		const geometryIds = /* @__PURE__ */ new Set();
+		const materialIds = /* @__PURE__ */ new Set();
+		const textureIds = /* @__PURE__ */ new Set();
+		for (const mesh of this.drawList) {
+			const geometry = mesh.data;
+			const material = mesh.material;
+			if (geometry !== void 0 && !geometryIds.has(geometry.id)) {
+				geometryIds.add(geometry.id);
+				geometryList.push(geometry);
+			}
+			if (material === void 0) continue;
+			if (!materialIds.has(material.id)) {
+				materialIds.add(material.id);
+				materialList.push(material);
+			}
+			for (const texture of GetMeshTextures(mesh)) if (!textureIds.has(texture.id)) {
+				textureIds.add(texture.id);
+				textureList.push(texture);
+			}
+			if (geometry !== void 0) this.addMaterialGeometryType(material.id, geometry.type);
+		}
+		this.geometryList = geometryList;
+		this.materialList = materialList;
+		this.textureList = textureList;
+		this._textureSnapshot = this.version;
+	}
+	/**
+	* 更新绘制列表及其关联资源列表。
+	* 保留原方法名，现有调用会同步更新全部四个列表。
+	* @returns 更新后的绘制列表
+	*/
+	updateDrawList() {
+		return this.updateLists();
+	}
+	/**
+	* 根据材质列表单独刷新 Texture 列表。
+	* 适用于只替换 Style 中 solid、edge、points.texture 的普通渲染帧。
+	* @returns 更新后的贴图列表
+	*/
+	updateTextureList() {
+		if (this._textureSnapshot === this.version) return this.textureList;
+		const previousTextureList = this.textureList;
+		const textureList = [];
+		const textureIds = /* @__PURE__ */ new Set();
+		for (const mesh of this.drawList) for (const texture of GetMeshTextures(mesh)) if (!textureIds.has(texture.id)) {
+			textureIds.add(texture.id);
+			textureList.push(texture);
+		}
+		this.textureList = textureList;
+		if (!HaveSameTextureIds(previousTextureList, textureList)) this.updateVersion();
+		this._textureSnapshot = this.version;
+		return this.textureList;
+	}
+	/**
+	* 获取当前场景中一个材质实际使用的几何类型，供 materialList 创建管线。
+	* @param materialId 材质 ID
+	* @returns 几何类型只读集合；不要修改返回的内部集合
+	*/
+	getMaterialGeometryTypes(materialId) {
+		return this._materialGeometryTypes.get(materialId) ?? /* @__PURE__ */ new Set();
+	}
+	/**
+	* 记录一个实际 Mesh 的材质与几何类型组合。
+	* @param materialId 材质 ID
+	* @param geometryType 几何类型
+	*/
+	addMaterialGeometryType(materialId, geometryType) {
+		let types = this._materialGeometryTypes.get(materialId);
+		if (types === void 0) {
+			types = /* @__PURE__ */ new Set();
+			this._materialGeometryTypes.set(materialId, types);
+		}
+		types.add(geometryType);
+	}
+	/**
+	* 更新场景绘制顺序。
+	* 仅按照 Mesh 的 order 从小到大重新排列 drawList，不重建其他资源列表。
+	* @returns 无返回值
+	*/
+	updateDrawOrder() {
+		this.drawList.sort((left, right) => {
+			return left.order - right.order;
+		});
+	}
+};
+/**
+* 获取网格使用的单层图片或实例层表；列表由调用者按 ID 去重。
+* @param mesh 普通或实例网格
+* @returns 材质引用的贴图列表
+*/
+var GetMeshTextures = (mesh) => {
+	return mesh.textures.filter((texture) => texture !== void 0);
+};
+/**
+* 比较两个贴图列表是否包含相同 ID。
+* @param left 左侧贴图列表
+* @param right 右侧贴图列表
+* @returns 是否包含相同贴图 ID
+*/
+var HaveSameTextureIds = (left, right) => {
+	if (left.length !== right.length) return false;
+	const rightIds = new Set(right.map((texture) => texture.id));
+	return left.every((texture) => rightIds.has(texture.id));
+};
+//#endregion
+export { Scene as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Scene/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Scene/index.ts"],"sourcesContent":["import type { AddObject, Geometry2d, Material2d } from \"../global-types\";\nimport Group from \"../Group\";\nimport type { GroupLike } from \"../Group\";\nimport Mesh from \"../Mesh\";\nimport type { MeshLike } from \"../Mesh\";\nimport type { TextureResource } from \"../Texture/Layers\";\n\ntype DrawList = MeshLike;\ntype GeometryList = Geometry2d;\ntype MaterialList = Material2d;\ntype TextureList = TextureResource;\n\ninterface SceneLike extends GroupLike {\n    drawList: DrawList[];\n    geometryList: GeometryList[];\n    materialList: MaterialList[];\n    textureList: TextureList[];\n    ensureLists(): DrawList[];\n    addToLists(child: AddObject): void;\n    removeFromLists(child: AddObject): void;\n    updateLists(): DrawList[];\n    updateResourceLists(): void;\n    updateDrawList(): DrawList[];\n    updateTextureList(): TextureList[];\n    getMaterialGeometryTypes(materialId: number): ReadonlySet<string>;\n    updateDrawOrder(): void;\n}\n\n/**\n * 场景对象\n * 作为场景树的根级容器使用\n * @class\n */\nclass Scene extends Group implements SceneLike {\n    /**\n     * 对象类型\n     */\n    public readonly type: string = \"Scene\";\n\n    /** CPU 四个列表与贴图列表分别处理到的版本快照，不是额外版本源。 */\n    private _listsSnapshot: number = -1;\n    private _textureSnapshot: number = -1;\n\n    /**\n     * 当前 Scene 中材质实际搭配的几何类型，不使用材质历史类型创建闲置模板。\n     */\n    private readonly _materialGeometryTypes = new Map<number, Set<string>>();\n\n\n    /**\n     * 当前绘制列表\n     */\n    drawList: DrawList[] = [];\n\n    /**\n     * 当前场景使用的去重 Geometry 列表。\n     * 多个 Mesh 共用同一 Geometry 时只保留一个对象引用。\n     */\n    geometryList: GeometryList[] = [];\n\n    /**\n     * 当前场景使用的去重 Material 列表。\n     * Material 对象同时提供 id 和 key，分别用于资源销毁与 Pipeline 复用。\n     */\n    materialList: MaterialList[] = [];\n\n    /**\n     * 当前场景使用的去重 Texture 列表。\n     */\n    textureList: TextureList[] = [];\n\n    /**\n     * 创建场景对象\n     */\n    public constructor() {\n        super(0, 0);\n    }\n\n    /** 版本变化后统一重建四个列表；一个 Render 处理后不影响其他 Render 的缓存快照。 */\n    public ensureLists(): DrawList[] {\n        if (this._listsSnapshot !== this.version) this.updateLists();\n        return this.drawList;\n    }\n\n    /**\n     * 将新加入场景的节点及其后代增量写入四个列表。\n     * 该方法只负责补充引用；删除节点时由 removeFromLists 处理共享资源校准。\n     * @param child 新加入场景树的节点\n     * @returns 无返回值\n     */\n    public addToLists(child: AddObject): void {\n        const collect = (node: AddObject): void => {\n            if (node instanceof Mesh && node.data !== undefined && node.material !== undefined) {\n                if (!this.drawList.some((mesh: DrawList): boolean => mesh.id === node.id)) {\n                    this.drawList.push(node);\n                }\n\n                if (!this.geometryList.some((geometry: GeometryList): boolean => geometry.id === node.data?.id)) {\n                    this.geometryList.push(node.data);\n                }\n\n                if (!this.materialList.some((material: MaterialList): boolean => material.id === node.material?.id)) {\n                    this.materialList.push(node.material);\n                }\n                this.addMaterialGeometryType(node.material.id, node.data.type);\n\n                for (const texture of GetMeshTextures(node)) {\n                    if (!this.textureList.some((item: TextureList): boolean => item.id === texture.id)) {\n                        this.textureList.push(texture);\n                    }\n                }\n            }\n\n            if (node instanceof Group) {\n                for (const nextChild of node.children) {\n                    collect(nextChild);\n                }\n            }\n        };\n\n        collect(child);\n        this.updateDrawOrder();\n    }\n\n    /**\n     * 从 drawList 中移除节点及其后代包含的 Mesh。\n     * 资源可能仍被其他 Mesh 共用，因此只标记下一帧重建另外三个资源列表。\n     * @param child 从场景树删除的节点\n     * @returns 无返回值\n     */\n    public removeFromLists(child: AddObject): void {\n        const removedMeshIds: Set<number> = new Set<number>();\n        const collect = (node: AddObject): void => {\n            if (node instanceof Mesh) {\n                removedMeshIds.add(node.id);\n            }\n\n            if (node instanceof Group) {\n                for (const nextChild of node.children) {\n                    collect(nextChild);\n                }\n            }\n        };\n\n        collect(child);\n\n        if (removedMeshIds.size === 0) {\n            return;\n        }\n\n        this.drawList = this.drawList.filter((mesh: DrawList): boolean => {\n            return !removedMeshIds.has(mesh.id);\n        });\n        this.updateVersion();\n    }\n\n    /**\n     * 一次递归更新场景的 Mesh、Geometry、Material 和 Texture 四个列表。\n     * Geometry、Material 与 Texture 按全局 ID 去重，供 Render 创建和回收缓存。\n     * @returns 更新后的绘制列表\n     */\n    public updateLists(): DrawList[] {\n        this.updateVersion();\n        const drawList: DrawList[] = [];\n        const collect = (child: AddObject): void => {\n            if (child instanceof Mesh && child.data !== undefined && child.material !== undefined) {\n                drawList.push(child);\n            }\n\n            if (child instanceof Group) {\n                for (const nextChild of child.children) {\n                    collect(nextChild);\n                }\n            }\n        };\n\n        for (const child of this.children) {\n            collect(child);\n        }\n        this.drawList = drawList;\n        this.updateResourceLists();\n        this.updateDrawOrder();\n        this._listsSnapshot = this.version;\n        return this.drawList;\n    }\n\n    /**\n     * 根据当前 drawList 重建 Geometry、Material 和 Texture 三个资源列表。\n     * 资源按全局 ID 去重，避免删除共享资源时误伤仍在场景中的 Mesh。\n     * @returns 无返回值\n     */\n    public updateResourceLists(): void {\n        this._materialGeometryTypes.clear();\n        const geometryList: GeometryList[] = [];\n        const materialList: MaterialList[] = [];\n        const textureList: TextureList[] = [];\n        const geometryIds: Set<number> = new Set<number>();\n        const materialIds: Set<number> = new Set<number>();\n        const textureIds: Set<number> = new Set<number>();\n\n        for (const mesh of this.drawList) {\n            const geometry: GeometryList | undefined = mesh.data;\n            const material: MaterialList | undefined = mesh.material;\n\n            if (geometry !== undefined && !geometryIds.has(geometry.id)) {\n                geometryIds.add(geometry.id);\n                geometryList.push(geometry);\n            }\n\n            if (material === undefined) {\n                continue;\n            }\n\n            if (!materialIds.has(material.id)) {\n                materialIds.add(material.id);\n                materialList.push(material);\n            }\n\n            for (const texture of GetMeshTextures(mesh)) {\n                if (!textureIds.has(texture.id)) {\n                    textureIds.add(texture.id);\n                    textureList.push(texture);\n                }\n            }\n\n            if (geometry !== undefined) this.addMaterialGeometryType(material.id, geometry.type);\n        }\n\n        this.geometryList = geometryList;\n        this.materialList = materialList;\n        this.textureList = textureList;\n        this._textureSnapshot = this.version;\n    }\n\n    /**\n     * 更新绘制列表及其关联资源列表。\n     * 保留原方法名，现有调用会同步更新全部四个列表。\n     * @returns 更新后的绘制列表\n     */\n    public updateDrawList(): DrawList[] {\n        return this.updateLists();\n    }\n\n    /**\n     * 根据材质列表单独刷新 Texture 列表。\n     * 适用于只替换 Style 中 solid、edge、points.texture 的普通渲染帧。\n     * @returns 更新后的贴图列表\n     */\n    public updateTextureList(): TextureList[] {\n        // Material -> Mesh 通知增加 Scene 版本，静止帧不扫描材质版本。\n        if (this._textureSnapshot === this.version) return this.textureList;\n\n        const previousTextureList: TextureList[] = this.textureList;\n        const textureList: TextureList[] = [];\n        const textureIds: Set<number> = new Set<number>();\n\n        for (const mesh of this.drawList) {\n            for (const texture of GetMeshTextures(mesh)) {\n                if (!textureIds.has(texture.id)) {\n                    textureIds.add(texture.id);\n                    textureList.push(texture);\n                }\n            }\n\n        }\n\n        this.textureList = textureList;\n        if (!HaveSameTextureIds(previousTextureList, textureList)) {\n            this.updateVersion();\n        }\n        this._textureSnapshot = this.version;\n        return this.textureList;\n    }\n\n    /**\n     * 获取当前场景中一个材质实际使用的几何类型，供 materialList 创建管线。\n     * @param materialId 材质 ID\n     * @returns 几何类型只读集合；不要修改返回的内部集合\n     */\n    public getMaterialGeometryTypes(materialId: number): ReadonlySet<string> {\n        return this._materialGeometryTypes.get(materialId) ?? new Set<string>();\n    }\n\n    /**\n     * 记录一个实际 Mesh 的材质与几何类型组合。\n     * @param materialId 材质 ID\n     * @param geometryType 几何类型\n     */\n    private addMaterialGeometryType(materialId: number, geometryType: string): void {\n        let types = this._materialGeometryTypes.get(materialId);\n        if (types === undefined) {\n            types = new Set<string>();\n            this._materialGeometryTypes.set(materialId, types);\n        }\n        types.add(geometryType);\n    }\n\n    /**\n     * 更新场景绘制顺序。\n     * 仅按照 Mesh 的 order 从小到大重新排列 drawList，不重建其他资源列表。\n     * @returns 无返回值\n     */\n    public updateDrawOrder(): void {\n        this.drawList.sort((left: DrawList, right: DrawList): number => {\n            return left.order - right.order;\n        });\n\n    }\n\n}\n\n/**\n * 获取网格使用的单层图片或实例层表；列表由调用者按 ID 去重。\n * @param mesh 普通或实例网格\n * @returns 材质引用的贴图列表\n */\nconst GetMeshTextures = (mesh: MeshLike): TextureResource[] => {\n    return mesh.textures.filter((texture): texture is TextureResource => texture !== undefined);\n};\n\n/**\n * 比较两个贴图列表是否包含相同 ID。\n * @param left 左侧贴图列表\n * @param right 右侧贴图列表\n * @returns 是否包含相同贴图 ID\n */\nconst HaveSameTextureIds = (left: readonly TextureResource[], right: readonly TextureResource[]): boolean => {\n    if (left.length !== right.length) {\n        return false;\n    }\n\n    const rightIds: Set<number> = new Set<number>(right.map((texture: TextureResource): number => texture.id));\n\n    return left.every((texture: TextureResource): boolean => rightIds.has(texture.id));\n};\n\nexport default Scene;\nexport type { DrawList, GeometryList, MaterialList, SceneLike, TextureList };\n"],"mappings":"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"}

package/lib/Style/EdgeStyle.d.ts

@@ -0,0 +1,28 @@
+import TexturedStyle from "./TexturedStyle";
+import type { BorderAlign, PixelAligned } from "./types";
+/** 有宽度的实体三角面边框样式。 */
+declare class EdgeStyle extends TexturedStyle {
+    /** 创建关闭的实体边框，顺向重复、横向固定。 */
+    constructor();
+    private _width;
+    /** 实体边框宽度，0 不生成边框。 */
+    get width(): number;
+    /** @param value 实体边框宽度，0 不生成边框。 */
+    set width(value: number);
+    private _borderAlign;
+    /** 边框对齐：inset / normal / outset。 */
+    get borderAlign(): BorderAlign;
+    /** @param value 边框对齐：inset / normal / outset。 */
+    set borderAlign(value: BorderAlign);
+    private _pixelAligned;
+    /** px 固定像素，zoom 随相机缩放。 */
+    get pixelAligned(): PixelAligned;
+    /** @param value px 固定像素，zoom 随相机缩放。 */
+    set pixelAligned(value: PixelAligned);
+    private _uvRepeat;
+    /** 沿完整轮廓的 UV 重复次数。 */
+    get uvRepeat(): number;
+    /** @param value 沿完整轮廓的 UV 重复次数。 */
+    set uvRepeat(value: number);
+}
+export default EdgeStyle;

package/lib/Style/EdgeStyle.js

@@ -0,0 +1,67 @@
+import { NormalizeSize } from "./PartStyle.js";
+import TexturedStyle from "./TexturedStyle.js";
+//#region src/scripts/Style/EdgeStyle.ts
+/** 有宽度的实体三角面边框样式。 */
+var EdgeStyle = class extends TexturedStyle {
+	/** 创建关闭的实体边框，顺向重复、横向固定。 */
+	constructor() {
+		super("edge");
+		this.addressModeV = "clamp-to-edge";
+	}
+	_width = 1;
+	/** 实体边框宽度，0 不生成边框。 */
+	get width() {
+		return this._width;
+	}
+	/** @param value 实体边框宽度，0 不生成边框。 */
+	set width(value) {
+		value = NormalizeSize(value);
+		if (this._width === value) return;
+		this._width = value;
+		this.notify("width");
+	}
+	_borderAlign = "normal";
+	/** 边框对齐：inset / normal / outset。 */
+	get borderAlign() {
+		return this._borderAlign;
+	}
+	/** @param value 边框对齐：inset / normal / outset。 */
+	set borderAlign(value) {
+		if (![
+			"inset",
+			"normal",
+			"outset"
+		].includes(value)) throw new TypeError("Invalid border alignment.");
+		if (this._borderAlign === value) return;
+		this._borderAlign = value;
+		this.notify("borderAlign");
+	}
+	_pixelAligned = "px";
+	/** px 固定像素，zoom 随相机缩放。 */
+	get pixelAligned() {
+		return this._pixelAligned;
+	}
+	/** @param value px 固定像素，zoom 随相机缩放。 */
+	set pixelAligned(value) {
+		if (!["px", "zoom"].includes(value)) throw new TypeError("Invalid pixel alignment.");
+		if (this._pixelAligned === value) return;
+		this._pixelAligned = value;
+		this.notify("pixelAligned");
+	}
+	_uvRepeat = 1;
+	/** 沿完整轮廓的 UV 重复次数。 */
+	get uvRepeat() {
+		return this._uvRepeat;
+	}
+	/** @param value 沿完整轮廓的 UV 重复次数。 */
+	set uvRepeat(value) {
+		value = NormalizeSize(value);
+		if (this._uvRepeat === value) return;
+		this._uvRepeat = value;
+		this.notify("uvRepeat");
+	}
+};
+//#endregion
+export { EdgeStyle as default };
+
+//# sourceMappingURL=EdgeStyle.js.map

package/lib/Style/EdgeStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeStyle.js","names":[],"sources":["../../src/scripts/Style/EdgeStyle.ts"],"sourcesContent":["import TexturedStyle from \"./TexturedStyle\";\nimport { NormalizeSize } from \"./PartStyle\";\nimport type { BorderAlign, PixelAligned } from \"./types\";\n\n/** 有宽度的实体三角面边框样式。 */\nclass EdgeStyle extends TexturedStyle {\n    /** 创建关闭的实体边框，顺向重复、横向固定。 */\n    public constructor() {\n        super(\"edge\");\n        this.addressModeV = \"clamp-to-edge\";\n    }\n\n    private _width: number = 1;\n    /** 实体边框宽度，0 不生成边框。 */\n    public get width(): number { return this._width; }\n    /** @param value 实体边框宽度，0 不生成边框。 */\n    public set width(value: number) {\n        value = NormalizeSize(value);\n        if (this._width === value) return;\n        this._width = value;\n        this.notify(\"width\");\n    }\n\n    private _borderAlign: BorderAlign = \"normal\";\n    /** 边框对齐：inset / normal / outset。 */\n    public get borderAlign(): BorderAlign { return this._borderAlign; }\n    /** @param value 边框对齐：inset / normal / outset。 */\n    public set borderAlign(value: BorderAlign) {\n        if (![\"inset\", \"normal\", \"outset\"].includes(value)) throw new TypeError(\"Invalid border alignment.\");\n        if (this._borderAlign === value) return;\n        this._borderAlign = value;\n        this.notify(\"borderAlign\");\n    }\n\n    private _pixelAligned: PixelAligned = \"px\";\n    /** px 固定像素，zoom 随相机缩放。 */\n    public get pixelAligned(): PixelAligned { return this._pixelAligned; }\n    /** @param value px 固定像素，zoom 随相机缩放。 */\n    public set pixelAligned(value: PixelAligned) {\n        if (![\"px\", \"zoom\"].includes(value)) throw new TypeError(\"Invalid pixel alignment.\");\n        if (this._pixelAligned === value) return;\n        this._pixelAligned = value;\n        this.notify(\"pixelAligned\");\n    }\n\n\n    private _uvRepeat: number = 1;\n    /** 沿完整轮廓的 UV 重复次数。 */\n    public get uvRepeat(): number { return this._uvRepeat; }\n    /** @param value 沿完整轮廓的 UV 重复次数。 */\n    public set uvRepeat(value: number) {\n        value = NormalizeSize(value);\n        if (this._uvRepeat === value) return;\n        this._uvRepeat = value;\n        this.notify(\"uvRepeat\");\n    }\n\n}\nexport default EdgeStyle;\n"],"mappings":";;;;AAKA,IAAM,YAAN,cAAwB,cAAc;;CAElC,cAAqB;EACjB,MAAM,MAAM;EACZ,KAAK,eAAe;CACxB;CAEA,SAAyB;;CAEzB,IAAW,QAAgB;EAAE,OAAO,KAAK;CAAQ;;CAEjD,IAAW,MAAM,OAAe;EAC5B,QAAQ,cAAc,KAAK;EAC3B,IAAI,KAAK,WAAW,OAAO;EAC3B,KAAK,SAAS;EACd,KAAK,OAAO,OAAO;CACvB;CAEA,eAAoC;;CAEpC,IAAW,cAA2B;EAAE,OAAO,KAAK;CAAc;;CAElE,IAAW,YAAY,OAAoB;EACvC,IAAI,CAAC;GAAC;GAAS;GAAU;EAAQ,CAAC,CAAC,SAAS,KAAK,GAAG,MAAM,IAAI,UAAU,2BAA2B;EACnG,IAAI,KAAK,iBAAiB,OAAO;EACjC,KAAK,eAAe;EACpB,KAAK,OAAO,aAAa;CAC7B;CAEA,gBAAsC;;CAEtC,IAAW,eAA6B;EAAE,OAAO,KAAK;CAAe;;CAErE,IAAW,aAAa,OAAqB;EACzC,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,MAAM,IAAI,UAAU,0BAA0B;EACnF,IAAI,KAAK,kBAAkB,OAAO;EAClC,KAAK,gBAAgB;EACrB,KAAK,OAAO,cAAc;CAC9B;CAGA,YAA4B;;CAE5B,IAAW,WAAmB;EAAE,OAAO,KAAK;CAAW;;CAEvD,IAAW,SAAS,OAAe;EAC/B,QAAQ,cAAc,KAAK;EAC3B,IAAI,KAAK,cAAc,OAAO;EAC9B,KAAK,YAAY;EACjB,KAAK,OAAO,UAAU;CAC1B;AAEJ"}

package/lib/Style/JoinStyle.d.ts

@@ -0,0 +1,27 @@
+import type { PartSubscriber } from "./types";
+/** miter 尖角斜接、round 圆接、bevel 切角连接。 */
+type JoinType = "miter" | "round" | "bevel";
+/** 多边形节点连接样式，只控制几何拓扑，不拥有颜色、宽度或 GPU 缓存。 */
+declare class JoinStyle {
+    private _type;
+    private _seg;
+    private readonly _subscribers;
+    /** 默认尖角；bevel 切掉尖端，但不会断开边框。 */
+    get type(): JoinType;
+    /** @param value 节点连接类型 */
+    set type(value: JoinType);
+    /** 每个圆接的细分段数，默认 8；不影响填充面或原生线框。 */
+    get seg(): number;
+    /** @param value 1 到 4096 的整数，只有 round 使用此精度 */
+    set seg(value: number);
+    /** @param subscriber 通常为所属 Style */
+    add(subscriber: PartSubscriber): void;
+    /** @param subscriber 要解绑的 Style */
+    delete(subscriber: PartSubscriber): void;
+    /** 清理订阅，不销毁其他对象。 */
+    dispose(): void;
+    /** @param field 改变的字段 */
+    private notify;
+}
+export default JoinStyle;
+export type { JoinType };

package/lib/Style/JoinStyle.js

@@ -0,0 +1,53 @@
+//#region src/scripts/Style/JoinStyle.ts
+/** 多边形节点连接样式，只控制几何拓扑，不拥有颜色、宽度或 GPU 缓存。 */
+var JoinStyle = class {
+	_type = "miter";
+	_seg = 8;
+	_subscribers = /* @__PURE__ */ new Set();
+	/** 默认尖角；bevel 切掉尖端，但不会断开边框。 */
+	get type() {
+		return this._type;
+	}
+	/** @param value 节点连接类型 */
+	set type(value) {
+		if (![
+			"miter",
+			"round",
+			"bevel"
+		].includes(value)) throw new TypeError("Invalid join type.");
+		if (this._type === value) return;
+		this._type = value;
+		this.notify("type");
+	}
+	/** 每个圆接的细分段数，默认 8；不影响填充面或原生线框。 */
+	get seg() {
+		return this._seg;
+	}
+	/** @param value 1 到 4096 的整数，只有 round 使用此精度 */
+	set seg(value) {
+		if (!Number.isInteger(value) || value < 1 || value > 4096) throw new RangeError("Join seg must be an integer in [1, 4096].");
+		if (this._seg === value) return;
+		this._seg = value;
+		this.notify("seg");
+	}
+	/** @param subscriber 通常为所属 Style */
+	add(subscriber) {
+		this._subscribers.add(subscriber);
+	}
+	/** @param subscriber 要解绑的 Style */
+	delete(subscriber) {
+		this._subscribers.delete(subscriber);
+	}
+	/** 清理订阅，不销毁其他对象。 */
+	dispose() {
+		this._subscribers.clear();
+	}
+	/** @param field 改变的字段 */
+	notify(field) {
+		for (const subscriber of [...this._subscribers]) subscriber.onPartChange("join", field);
+	}
+};
+//#endregion
+export { JoinStyle as default };
+
+//# sourceMappingURL=JoinStyle.js.map

package/lib/Style/JoinStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinStyle.js","names":[],"sources":["../../src/scripts/Style/JoinStyle.ts"],"sourcesContent":["import type { PartSubscriber } from \"./types\";\n\n/** miter 尖角斜接、round 圆接、bevel 切角连接。 */\ntype JoinType = \"miter\" | \"round\" | \"bevel\";\n\n/** 多边形节点连接样式，只控制几何拓扑，不拥有颜色、宽度或 GPU 缓存。 */\nclass JoinStyle {\n    private _type: JoinType = \"miter\";\n    private _seg: number = 8;\n    private readonly _subscribers = new Set<PartSubscriber>();\n\n    /** 默认尖角；bevel 切掉尖端，但不会断开边框。 */\n    public get type(): JoinType { return this._type; }\n    /** @param value 节点连接类型 */\n    public set type(value: JoinType) {\n        if (![\"miter\", \"round\", \"bevel\"].includes(value)) throw new TypeError(\"Invalid join type.\");\n        if (this._type === value) return;\n        this._type = value;\n        this.notify(\"type\");\n    }\n    /** 每个圆接的细分段数，默认 8；不影响填充面或原生线框。 */\n    public get seg(): number { return this._seg; }\n    /** @param value 1 到 4096 的整数，只有 round 使用此精度 */\n    public set seg(value: number) {\n        if (!Number.isInteger(value) || value < 1 || value > 4096) throw new RangeError(\"Join seg must be an integer in [1, 4096].\");\n        if (this._seg === value) return;\n        this._seg = value;\n        this.notify(\"seg\");\n    }\n    /** @param subscriber 通常为所属 Style */\n    public add(subscriber: PartSubscriber): void { this._subscribers.add(subscriber); }\n    /** @param subscriber 要解绑的 Style */\n    public delete(subscriber: PartSubscriber): void { this._subscribers.delete(subscriber); }\n    /** 清理订阅，不销毁其他对象。 */\n    public dispose(): void { this._subscribers.clear(); }\n    /** @param field 改变的字段 */\n    private notify(field: string): void {\n        for (const subscriber of [...this._subscribers]) subscriber.onPartChange(\"join\", field);\n    }\n}\n\nexport default JoinStyle;\nexport type { JoinType };\n"],"mappings":";;AAMA,IAAM,YAAN,MAAgB;CACZ,QAA0B;CAC1B,OAAuB;CACvB,+BAAgC,IAAI,IAAoB;;CAGxD,IAAW,OAAiB;EAAE,OAAO,KAAK;CAAO;;CAEjD,IAAW,KAAK,OAAiB;EAC7B,IAAI,CAAC;GAAC;GAAS;GAAS;EAAO,CAAC,CAAC,SAAS,KAAK,GAAG,MAAM,IAAI,UAAU,oBAAoB;EAC1F,IAAI,KAAK,UAAU,OAAO;EAC1B,KAAK,QAAQ;EACb,KAAK,OAAO,MAAM;CACtB;;CAEA,IAAW,MAAc;EAAE,OAAO,KAAK;CAAM;;CAE7C,IAAW,IAAI,OAAe;EAC1B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,KAAK,QAAQ,MAAM,MAAM,IAAI,WAAW,2CAA2C;EAC3H,IAAI,KAAK,SAAS,OAAO;EACzB,KAAK,OAAO;EACZ,KAAK,OAAO,KAAK;CACrB;;CAEA,IAAW,YAAkC;EAAE,KAAK,aAAa,IAAI,UAAU;CAAG;;CAElF,OAAc,YAAkC;EAAE,KAAK,aAAa,OAAO,UAAU;CAAG;;CAExF,UAAuB;EAAE,KAAK,aAAa,MAAM;CAAG;;CAEpD,OAAe,OAAqB;EAChC,KAAK,MAAM,cAAc,CAAC,GAAG,KAAK,YAAY,GAAG,WAAW,aAAa,QAAQ,KAAK;CAC1F;AACJ"}

package/lib/Style/PartStyle.d.ts

@@ -0,0 +1,50 @@
+import Color from "../Color";
+import type { ColorSubscriber } from "../Color";
+import type { PartSubscriber, StyleArea } from "./types";
+/** 四个样式分区的共同基础，仅管理显示、颜色、透明度和订阅。 */
+declare class PartStyle implements ColorSubscriber {
+    /** 分区身份。 */
+    readonly area: Exclude<StyleArea, "whole">;
+    private readonly _subscribers;
+    private _enabled;
+    private _color;
+    private _opacity;
+    /**
+     * 创建分区并订阅默认颜色。
+     * @param area 分区身份
+     */
+    constructor(area: Exclude<StyleArea, "whole">);
+    /** 是否生成并显示该分区，默认关闭。 */
+    get enabled(): boolean;
+    /** @param value 是否启用该分区 */
+    set enabled(value: boolean);
+    /** 该分区独立颜色，默认不透明白色。 */
+    get color(): Color;
+    /** @param value 新颜色引用；先解绑旧颜色，再订阅新颜色 */
+    set color(value: Color);
+    /** 该分区独立透明度，作用于最终输出 alpha。 */
+    get opacity(): number;
+    /** @param value 透明度，钳制到 0 到 1 */
+    set opacity(value: number);
+    /** @param subscriber 分区变化接收者 */
+    add(subscriber: PartSubscriber): void;
+    /** @param subscriber 要解除的接收者；不销毁对象或 GPU 缓存 */
+    delete(subscriber: PartSubscriber): void;
+    /** 最终停止使用时解除颜色订阅及分区订阅；不销毁共享 Color。 */
+    dispose(): void;
+    /**
+     * 接收颜色的字段级通知。
+     * @param color 来源颜色
+     * @param field 颜色属性名
+     */
+    onColorChange(color: Color, field: string): void;
+    /** @param field 实际变化的字段名 */
+    protected notify(field: string): void;
+}
+/**
+ * 验证尺寸参数并钳制负值；拒绝非有限值，避免污染几何和 GPU 数据。
+ * @param value 待验证数值
+ * @returns 非负有限值
+ */
+export declare const NormalizeSize: (value: number) => number;
+export default PartStyle;