bplinejs 0.0.101-beta.10

package/lib/Style/index.js

@@ -0,0 +1,92 @@
+import SolidStyle from "./SolidStyle.js";
+import WireframeStyle from "./WireframeStyle.js";
+import EdgeStyle from "./EdgeStyle.js";
+import PointsStyle from "./PointsStyle.js";
+import JoinStyle from "./JoinStyle.js";
+import { STYLE_STRIDE, WriteStyleData } from "./WriteStyleData.js";
+//#region src/scripts/Style/index.ts
+/** 共享样式；四个显示分区与节点连接样式独立持有参数，通过订阅链通知使用者。 */
+var Style = class {
+	_solid;
+	_wireframe;
+	_edge;
+	_points;
+	_join;
+	_subscribers = /* @__PURE__ */ new Set();
+	_version = 0;
+	/** 构建四个关闭的显示分区及默认尖角连接，并订阅它们的变化。 */
+	constructor() {
+		this._solid = new SolidStyle();
+		this._wireframe = new WireframeStyle();
+		this._edge = new EdgeStyle();
+		this._points = new PointsStyle();
+		this._join = new JoinStyle();
+		this._solid.add(this);
+		this._wireframe.add(this);
+		this._edge.add(this);
+		this._points.add(this);
+		this._join.add(this);
+	}
+	/** 实体面与 SDF 样式。 */
+	get solid() {
+		return this._solid;
+	}
+	/** 原生线框样式。 */
+	get wireframe() {
+		return this._wireframe;
+	}
+	/** 实体三角面边框样式。 */
+	get edge() {
+		return this._edge;
+	}
+	/** 关键点样式。 */
+	get points() {
+		return this._points;
+	}
+	/** 多边形连接类型和精度，由 Geometry.style 决定，不随实例单独生成。 */
+	get join() {
+		return this._join;
+	}
+	/** 任意分区变化时递增的单一版本。 */
+	get version() {
+		return this._version;
+	}
+	/** @param subscriber 几何、材质或未来实现通知协议的 IMesh */
+	add(subscriber) {
+		this._subscribers.add(subscriber);
+	}
+	/** @param subscriber 解除订阅的对象，不销毁资源 */
+	delete(subscriber) {
+		this._subscribers.delete(subscriber);
+	}
+	/**
+	* 最终停止使用时释放整条订阅链，不销毁共享颜色、贴图或 GPU 缓存。
+	* 仅在所有 Geometry / Material 均停止使用该 Style 后调用，不应再复用。
+	*/
+	dispose() {
+		this._solid.dispose();
+		this._wireframe.dispose();
+		this._edge.dispose();
+		this._points.dispose();
+		this._join.dispose();
+		this._subscribers.clear();
+	}
+	/**
+	* 将分区变化转发给使用者；接收者自行判断是否影响 CPU 几何。
+	* @param area 变化区域
+	* @param field 变化字段
+	*/
+	onPartChange(area, field) {
+		this._version++;
+		const change = Object.freeze({
+			source: this,
+			area,
+			field
+		});
+		for (const subscriber of [...this._subscribers]) subscriber.onStyleChange(change);
+	}
+};
+//#endregion
+export { EdgeStyle, JoinStyle, PointsStyle, STYLE_STRIDE, SolidStyle, WireframeStyle, WriteStyleData, Style as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Style/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Style/index.ts"],"sourcesContent":["import SolidStyle from \"./SolidStyle\";\nimport WireframeStyle from \"./WireframeStyle\";\nimport EdgeStyle from \"./EdgeStyle\";\nimport PointsStyle from \"./PointsStyle\";\nimport JoinStyle from \"./JoinStyle\";\nimport type { PartSubscriber, StyleArea, StyleSubscriber } from \"./types\";\n\n/** 共享样式；四个显示分区与节点连接样式独立持有参数，通过订阅链通知使用者。 */\nclass Style implements PartSubscriber {\n    private readonly _solid: SolidStyle;\n    private readonly _wireframe: WireframeStyle;\n    private readonly _edge: EdgeStyle;\n    private readonly _points: PointsStyle;\n    private readonly _join: JoinStyle;\n    private readonly _subscribers = new Set<StyleSubscriber>();\n    private _version: number = 0;\n\n    /** 构建四个关闭的显示分区及默认尖角连接，并订阅它们的变化。 */\n    public constructor() {\n        this._solid = new SolidStyle();\n        this._wireframe = new WireframeStyle();\n        this._edge = new EdgeStyle();\n        this._points = new PointsStyle();\n        this._join = new JoinStyle();\n        this._solid.add(this);\n        this._wireframe.add(this);\n        this._edge.add(this);\n        this._points.add(this);\n        this._join.add(this);\n    }\n    /** 实体面与 SDF 样式。 */\n    public get solid(): SolidStyle { return this._solid; }\n    /** 原生线框样式。 */\n    public get wireframe(): WireframeStyle { return this._wireframe; }\n    /** 实体三角面边框样式。 */\n    public get edge(): EdgeStyle { return this._edge; }\n    /** 关键点样式。 */\n    public get points(): PointsStyle { return this._points; }\n    /** 多边形连接类型和精度，由 Geometry.style 决定，不随实例单独生成。 */\n    public get join(): JoinStyle { return this._join; }\n    /** 任意分区变化时递增的单一版本。 */\n    public get version(): number { return this._version; }\n\n    /** @param subscriber 几何、材质或未来实现通知协议的 IMesh */\n    public add(subscriber: StyleSubscriber): void { this._subscribers.add(subscriber); }\n    /** @param subscriber 解除订阅的对象，不销毁资源 */\n    public delete(subscriber: StyleSubscriber): void { this._subscribers.delete(subscriber); }\n\n    /**\n     * 最终停止使用时释放整条订阅链，不销毁共享颜色、贴图或 GPU 缓存。\n     * 仅在所有 Geometry / Material 均停止使用该 Style 后调用，不应再复用。\n     */\n    public dispose(): void {\n        this._solid.dispose();\n        this._wireframe.dispose();\n        this._edge.dispose();\n        this._points.dispose();\n        this._join.dispose();\n        this._subscribers.clear();\n    }\n\n    /**\n     * 将分区变化转发给使用者；接收者自行判断是否影响 CPU 几何。\n     * @param area 变化区域\n     * @param field 变化字段\n     */\n    public onPartChange(area: Exclude<StyleArea, \"whole\">, field: string): void {\n        this._version++;\n        const change = Object.freeze({ source: this, area, field });\n        for (const subscriber of [...this._subscribers]) subscriber.onStyleChange(change);\n    }\n}\nexport default Style;\nexport { SolidStyle, WireframeStyle, EdgeStyle, PointsStyle, JoinStyle };\nexport type { JoinType } from \"./JoinStyle\";\nexport { WriteStyleData, STYLE_STRIDE } from \"./WriteStyleData\";\nexport type { StyleArea, StyleChange, StyleSubscriber, BorderAlign, PixelAligned, PartSubscriber } from \"./types\";\n"],"mappings":";;;;;;;;AAQA,IAAM,QAAN,MAAsC;CAClC;CACA;CACA;CACA;CACA;CACA,+BAAgC,IAAI,IAAqB;CACzD,WAA2B;;CAG3B,cAAqB;EACjB,KAAK,SAAS,IAAI,WAAW;EAC7B,KAAK,aAAa,IAAI,eAAe;EACrC,KAAK,QAAQ,IAAI,UAAU;EAC3B,KAAK,UAAU,IAAI,YAAY;EAC/B,KAAK,QAAQ,IAAI,UAAU;EAC3B,KAAK,OAAO,IAAI,IAAI;EACpB,KAAK,WAAW,IAAI,IAAI;EACxB,KAAK,MAAM,IAAI,IAAI;EACnB,KAAK,QAAQ,IAAI,IAAI;EACrB,KAAK,MAAM,IAAI,IAAI;CACvB;;CAEA,IAAW,QAAoB;EAAE,OAAO,KAAK;CAAQ;;CAErD,IAAW,YAA4B;EAAE,OAAO,KAAK;CAAY;;CAEjE,IAAW,OAAkB;EAAE,OAAO,KAAK;CAAO;;CAElD,IAAW,SAAsB;EAAE,OAAO,KAAK;CAAS;;CAExD,IAAW,OAAkB;EAAE,OAAO,KAAK;CAAO;;CAElD,IAAW,UAAkB;EAAE,OAAO,KAAK;CAAU;;CAGrD,IAAW,YAAmC;EAAE,KAAK,aAAa,IAAI,UAAU;CAAG;;CAEnF,OAAc,YAAmC;EAAE,KAAK,aAAa,OAAO,UAAU;CAAG;;;;;CAMzF,UAAuB;EACnB,KAAK,OAAO,QAAQ;EACpB,KAAK,WAAW,QAAQ;EACxB,KAAK,MAAM,QAAQ;EACnB,KAAK,QAAQ,QAAQ;EACrB,KAAK,MAAM,QAAQ;EACnB,KAAK,aAAa,MAAM;CAC5B;;;;;;CAOA,aAAoB,MAAmC,OAAqB;EACxE,KAAK;EACL,MAAM,SAAS,OAAO,OAAO;GAAE,QAAQ;GAAM;GAAM;EAAM,CAAC;EAC1D,KAAK,MAAM,cAAc,CAAC,GAAG,KAAK,YAAY,GAAG,WAAW,cAAc,MAAM;CACpF;AACJ"}

package/lib/Style/types.d.ts

@@ -0,0 +1,21 @@
+import type Style from "./index";
+/** 样式通知区域，whole 表示更换整个 Style。 */
+export type StyleArea = "solid" | "wireframe" | "edge" | "points" | "join" | "whole";
+/** 边框对齐方式。 */
+export type BorderAlign = "inset" | "normal" | "outset";
+/** px 固定屏幕像素，zoom 跟随相机缩放。 */
+export type PixelAligned = "px" | "zoom";
+/** 不携带 GPU 缓存的样式变化通知。 */
+export interface StyleChange {
+    readonly source: Style;
+    readonly area: StyleArea;
+    readonly field: string;
+}
+/** 开放式订阅协议；Geometry、Material 和未来 IMesh 都可实现。 */
+export interface StyleSubscriber {
+    onStyleChange(change: StyleChange): void;
+}
+/** 分区通知接收者，通常是所属 Style。 */
+export interface PartSubscriber {
+    onPartChange(area: Exclude<StyleArea, "whole">, field: string): void;
+}

package/lib/Texture/Layers.d.ts

@@ -0,0 +1,26 @@
+import type { TextureLike, TextureSubscriber } from "./index";
+/** 可上传贴图资源：单图也以一层的 2d-array 视图绑定。 */
+export type TextureResource = TextureLike | TextureLayers;
+/** 多层纹理的 CPU 引用集合，GPUTexture 仍只属于 Render。 */
+declare class TextureLayers implements TextureSubscriber {
+    /** 数组资源 ID，与层内图片 ID 独立。 */
+    readonly id: number;
+    /** 对象类型。 */
+    readonly type: string;
+    private _version;
+    private _layers;
+    /** 任一源图或层表变化时递增。 */
+    get version(): number;
+    /** 有序层表；undefined 对应白色，不改变其他层的编号。 */
+    get layers(): readonly (TextureLike | undefined)[];
+    /**
+     * 原子替换层表；相同引用序列不更新，不保留废弃源的订阅。
+     * @param layers 有序图片列表，由 IMesh 统一维护
+     */
+    set(layers: readonly (TextureLike | undefined)[]): void;
+    /** @param texture 已订阅图片，更新像素不需要重打包实例样式 */
+    onTextureChange(texture: TextureLike): void;
+    /** 解除图片订阅，不销毁共享图片或 GPU 缓存。 */
+    dispose(): void;
+}
+export default TextureLayers;

package/lib/Texture/Layers.js

@@ -0,0 +1,42 @@
+import { GETID } from "../ID.js";
+//#region src/scripts/Texture/Layers.ts
+/** 多层纹理的 CPU 引用集合，GPUTexture 仍只属于 Render。 */
+var TextureLayers = class {
+	/** 数组资源 ID，与层内图片 ID 独立。 */
+	id = GETID();
+	/** 对象类型。 */
+	type = "TextureLayers";
+	_version = 0;
+	_layers = [];
+	/** 任一源图或层表变化时递增。 */
+	get version() {
+		return this._version;
+	}
+	/** 有序层表；undefined 对应白色，不改变其他层的编号。 */
+	get layers() {
+		return this._layers;
+	}
+	/**
+	* 原子替换层表；相同引用序列不更新，不保留废弃源的订阅。
+	* @param layers 有序图片列表，由 IMesh 统一维护
+	*/
+	set(layers) {
+		if (layers.length === this._layers.length && layers.every((item, index) => item === this._layers[index])) return;
+		for (const texture of this._layers) texture?.delete(this);
+		this._layers = Object.freeze([...layers]);
+		for (const texture of this._layers) texture?.add(this);
+		this._version++;
+	}
+	/** @param texture 已订阅图片，更新像素不需要重打包实例样式 */
+	onTextureChange(texture) {
+		if (this._layers.includes(texture)) this._version++;
+	}
+	/** 解除图片订阅，不销毁共享图片或 GPU 缓存。 */
+	dispose() {
+		this.set([]);
+	}
+};
+//#endregion
+export { TextureLayers as default };
+
+//# sourceMappingURL=Layers.js.map

package/lib/Texture/Layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layers.js","names":[],"sources":["../../src/scripts/Texture/Layers.ts"],"sourcesContent":["import { GETID } from \"../ID\";\nimport type { TextureLike, TextureSubscriber } from \"./index\";\n\n/** 可上传贴图资源：单图也以一层的 2d-array 视图绑定。 */\nexport type TextureResource = TextureLike | TextureLayers;\n\n/** 多层纹理的 CPU 引用集合，GPUTexture 仍只属于 Render。 */\nclass TextureLayers implements TextureSubscriber {\n    /** 数组资源 ID，与层内图片 ID 独立。 */\n    public readonly id: number = GETID();\n    /** 对象类型。 */\n    public readonly type: string = \"TextureLayers\";\n    private _version: number = 0;\n    private _layers: readonly (TextureLike | undefined)[] = [];\n    /** 任一源图或层表变化时递增。 */\n    public get version(): number { return this._version; }\n    /** 有序层表；undefined 对应白色，不改变其他层的编号。 */\n    public get layers(): readonly (TextureLike | undefined)[] { return this._layers; }\n    /**\n     * 原子替换层表；相同引用序列不更新，不保留废弃源的订阅。\n     * @param layers 有序图片列表，由 IMesh 统一维护\n     */\n    public set(layers: readonly (TextureLike | undefined)[]): void {\n        if (layers.length === this._layers.length && layers.every((item, index): boolean => item === this._layers[index])) return;\n        for (const texture of this._layers) texture?.delete(this);\n        this._layers = Object.freeze([...layers]);\n        for (const texture of this._layers) texture?.add(this);\n        this._version++;\n    }\n    /** @param texture 已订阅图片，更新像素不需要重打包实例样式 */\n    public onTextureChange(texture: TextureLike): void {\n        if (this._layers.includes(texture)) this._version++;\n    }\n    /** 解除图片订阅，不销毁共享图片或 GPU 缓存。 */\n    public dispose(): void { this.set([]); }\n}\n\nexport default TextureLayers;\n"],"mappings":";;;AAOA,IAAM,gBAAN,MAAiD;;CAE7C,KAA6B,MAAM;;CAEnC,OAA+B;CAC/B,WAA2B;CAC3B,UAAwD,CAAC;;CAEzD,IAAW,UAAkB;EAAE,OAAO,KAAK;CAAU;;CAErD,IAAW,SAA+C;EAAE,OAAO,KAAK;CAAS;;;;;CAKjF,IAAW,QAAoD;EAC3D,IAAI,OAAO,WAAW,KAAK,QAAQ,UAAU,OAAO,OAAO,MAAM,UAAmB,SAAS,KAAK,QAAQ,MAAM,GAAG;EACnH,KAAK,MAAM,WAAW,KAAK,SAAS,SAAS,OAAO,IAAI;EACxD,KAAK,UAAU,OAAO,OAAO,CAAC,GAAG,MAAM,CAAC;EACxC,KAAK,MAAM,WAAW,KAAK,SAAS,SAAS,IAAI,IAAI;EACrD,KAAK;CACT;;CAEA,gBAAuB,SAA4B;EAC/C,IAAI,KAAK,QAAQ,SAAS,OAAO,GAAG,KAAK;CAC7C;;CAEA,UAAuB;EAAE,KAAK,IAAI,CAAC,CAAC;CAAG;AAC3C"}

package/lib/Texture/index.d.ts

@@ -0,0 +1,116 @@
+type TextureSource = HTMLImageElement | ImageBitmap | ImageData;
+/** 贴图消费者，通常由 Style 的贴图分区实现。 */
+interface TextureSubscriber {
+    onTextureChange(texture: TextureLike): void;
+}
+interface TextureLike {
+    readonly id: number;
+    readonly type: string;
+    readonly version: number;
+    url: string | null;
+    source: TextureSource | null;
+    loaded: boolean;
+    width: number;
+    height: number;
+    add(subscriber: TextureSubscriber): void;
+    delete(subscriber: TextureSubscriber): void;
+    updateVersion(): void;
+}
+/**
+ * 贴图对象
+ * 用于描述贴图资源本身
+ * 不直接绑定具体渲染后端的 GPU 纹理对象
+ * @class
+ */
+declare class Texture implements TextureLike {
+    /**
+     * 全局唯一贴图 ID
+     */
+    readonly id: number;
+    /**
+     * 对象类型
+     */
+    readonly type: string;
+    private _version;
+    private readonly _subscribers;
+    /**
+     * 贴图来源地址
+     */
+    private _url;
+    /**
+     * 贴图源数据
+     */
+    private _source;
+    /**
+     * 是否已加载完成
+     */
+    private _loaded;
+    /**
+     * 贴图宽度
+     */
+    private _width;
+    /**
+     * 贴图高度
+     */
+    private _height;
+    /**
+     * 创建贴图对象
+     */
+    constructor();
+    /** 单一贴图版本，每个 Render 独立记录已上传版本。 */
+    get version(): number;
+    /** 贴图来源地址；修改地址本身不会自动下载。 */
+    get url(): string | null;
+    /** @param value 来源地址，下载使用 load */
+    set url(value: string | null);
+    /** 当前浏览器图片源。 */
+    get source(): TextureSource | null;
+    /** @param value 新图片源；同步更新宽高和 loaded，null 清空 */
+    set source(value: TextureSource | null);
+    /** 当前图片是否可上传。 */
+    get loaded(): boolean;
+    /** @param value 是否已加载；正常情况由 setSource / clearSource 自动维护 */
+    set loaded(value: boolean);
+    /** 图片宽度，单位为源像素。 */
+    get width(): number;
+    /** @param value 源像素宽度，必须为非负整数 */
+    set width(value: number);
+    /** 图片高度，单位为源像素。 */
+    get height(): number;
+    /** @param value 源像素高度，必须为非负整数 */
+    set height(value: number);
+    /**
+     * 关联贴图消费者；多个分区可以共享同一 Texture。
+     * @param subscriber 消费者，重复 add 不会重复通知
+     */
+    add(subscriber: TextureSubscriber): void;
+    /**
+     * 解绑贴图消费者，不销毁图片源和任何 Render 的缓存。
+     * @param subscriber 需要解绑的消费者
+     */
+    delete(subscriber: TextureSubscriber): void;
+    /** 原地修改图片像素后手动递增版本并通知；各 Render 独立消费，不存在清除版本操作。 */
+    updateVersion(): void;
+    /**
+     * 设置贴图源数据
+     * @param source 贴图源数据
+     * @param url 贴图来源地址
+     * @returns 当前贴图对象
+     */
+    setSource(source: TextureSource, url?: string | null): this;
+    /**
+     * 清空贴图源数据
+     * @returns 当前贴图对象
+     */
+    clearSource(): this;
+    /**
+     * 从地址加载贴图
+     * @param url 贴图地址
+     * @returns 当前贴图对象
+     */
+    load(url: string): Promise<this>;
+}
+export default Texture;
+export type { TextureLike, TextureSource, TextureSubscriber };
+export { default as TextureLayers } from "./Layers";
+export type { TextureResource } from "./Layers";

package/lib/Texture/index.js

@@ -0,0 +1,198 @@
+import { GETID } from "../ID.js";
+import TextureLayers from "./Layers.js";
+//#region src/scripts/Texture/index.ts
+/**
+* 贴图对象
+* 用于描述贴图资源本身
+* 不直接绑定具体渲染后端的 GPU 纹理对象
+* @class
+*/
+var Texture = class {
+	/**
+	* 全局唯一贴图 ID
+	*/
+	id;
+	/**
+	* 对象类型
+	*/
+	type = "Texture";
+	_version = 0;
+	_subscribers = /* @__PURE__ */ new Set();
+	/**
+	* 贴图来源地址
+	*/
+	_url = null;
+	/**
+	* 贴图源数据
+	*/
+	_source = null;
+	/**
+	* 是否已加载完成
+	*/
+	_loaded = false;
+	/**
+	* 贴图宽度
+	*/
+	_width = 0;
+	/**
+	* 贴图高度
+	*/
+	_height = 0;
+	/**
+	* 创建贴图对象
+	*/
+	constructor() {
+		this.id = GETID();
+	}
+	/** 单一贴图版本，每个 Render 独立记录已上传版本。 */
+	get version() {
+		return this._version;
+	}
+	/** 贴图来源地址；修改地址本身不会自动下载。 */
+	get url() {
+		return this._url;
+	}
+	/** @param value 来源地址，下载使用 load */
+	set url(value) {
+		if (this._url === value) return;
+		this._url = value;
+		this.updateVersion();
+	}
+	/** 当前浏览器图片源。 */
+	get source() {
+		return this._source;
+	}
+	/** @param value 新图片源；同步更新宽高和 loaded，null 清空 */
+	set source(value) {
+		if (this._source === value) return;
+		if (value === null) this.clearSource();
+		else this.setSource(value, this._url);
+	}
+	/** 当前图片是否可上传。 */
+	get loaded() {
+		return this._loaded;
+	}
+	/** @param value 是否已加载；正常情况由 setSource / clearSource 自动维护 */
+	set loaded(value) {
+		if (this._loaded === value) return;
+		this._loaded = value;
+		this.updateVersion();
+	}
+	/** 图片宽度，单位为源像素。 */
+	get width() {
+		return this._width;
+	}
+	/** @param value 源像素宽度，必须为非负整数 */
+	set width(value) {
+		if (!Number.isInteger(value) || value < 0) throw new RangeError("Texture width must be a non-negative integer.");
+		if (this._width === value) return;
+		this._width = value;
+		this.updateVersion();
+	}
+	/** 图片高度，单位为源像素。 */
+	get height() {
+		return this._height;
+	}
+	/** @param value 源像素高度，必须为非负整数 */
+	set height(value) {
+		if (!Number.isInteger(value) || value < 0) throw new RangeError("Texture height must be a non-negative integer.");
+		if (this._height === value) return;
+		this._height = value;
+		this.updateVersion();
+	}
+	/**
+	* 关联贴图消费者；多个分区可以共享同一 Texture。
+	* @param subscriber 消费者，重复 add 不会重复通知
+	*/
+	add(subscriber) {
+		this._subscribers.add(subscriber);
+	}
+	/**
+	* 解绑贴图消费者，不销毁图片源和任何 Render 的缓存。
+	* @param subscriber 需要解绑的消费者
+	*/
+	delete(subscriber) {
+		this._subscribers.delete(subscriber);
+	}
+	/** 原地修改图片像素后手动递增版本并通知；各 Render 独立消费，不存在清除版本操作。 */
+	updateVersion() {
+		this._version++;
+		for (const subscriber of [...this._subscribers]) subscriber.onTextureChange(this);
+	}
+	/**
+	* 设置贴图源数据
+	* @param source 贴图源数据
+	* @param url 贴图来源地址
+	* @returns 当前贴图对象
+	*/
+	setSource(source, url = null) {
+		this._url = url;
+		this._source = source;
+		this._loaded = true;
+		this._width = GetTextureWidth(source);
+		this._height = GetTextureHeight(source);
+		this.updateVersion();
+		return this;
+	}
+	/**
+	* 清空贴图源数据
+	* @returns 当前贴图对象
+	*/
+	clearSource() {
+		this._url = null;
+		this._source = null;
+		this._loaded = false;
+		this._width = 0;
+		this._height = 0;
+		this.updateVersion();
+		return this;
+	}
+	/**
+	* 从地址加载贴图
+	* @param url 贴图地址
+	* @returns 当前贴图对象
+	*/
+	async load(url) {
+		const image = await LoadImage(url);
+		return this.setSource(image, url);
+	}
+};
+/**
+* 加载图片元素
+* @param url 图片地址
+* @returns 图片元素
+*/
+var LoadImage = (url) => {
+	return new Promise((resolve, reject) => {
+		const image = new Image();
+		image.onload = () => {
+			resolve(image);
+		};
+		image.onerror = () => {
+			reject(/* @__PURE__ */ new Error(`Texture load failed: ${url}`));
+		};
+		image.src = url;
+	});
+};
+/**
+* 获取贴图宽度
+* @param source 贴图源数据
+* @returns 贴图宽度
+*/
+var GetTextureWidth = (source) => {
+	if ("naturalWidth" in source) return source.naturalWidth;
+	return source.width;
+};
+/**
+* 获取贴图高度
+* @param source 贴图源数据
+* @returns 贴图高度
+*/
+var GetTextureHeight = (source) => {
+	if ("naturalHeight" in source) return source.naturalHeight;
+	return source.height;
+};
+//#endregion
+export { TextureLayers, Texture as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Texture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Texture/index.ts"],"sourcesContent":["import { GETID } from \"../ID\";\n\ntype TextureSource = HTMLImageElement | ImageBitmap | ImageData;\n\n/** 贴图消费者，通常由 Style 的贴图分区实现。 */\ninterface TextureSubscriber {\n    onTextureChange(texture: TextureLike): void;\n}\n\ninterface TextureLike {\n    readonly id: number;\n    readonly type: string;\n    readonly version: number;\n    url: string | null;\n    source: TextureSource | null;\n    loaded: boolean;\n    width: number;\n    height: number;\n    add(subscriber: TextureSubscriber): void;\n    delete(subscriber: TextureSubscriber): void;\n    updateVersion(): void;\n}\n\n/**\n * 贴图对象\n * 用于描述贴图资源本身\n * 不直接绑定具体渲染后端的 GPU 纹理对象\n * @class\n */\nclass Texture implements TextureLike {\n    /**\n     * 全局唯一贴图 ID\n     */\n    public readonly id: number;\n\n    /**\n     * 对象类型\n     */\n    public readonly type: string = \"Texture\";\n\n    private _version: number = 0;\n    private readonly _subscribers = new Set<TextureSubscriber>();\n\n    /**\n     * 贴图来源地址\n     */\n    private _url: string | null = null;\n\n    /**\n     * 贴图源数据\n     */\n    private _source: TextureSource | null = null;\n\n    /**\n     * 是否已加载完成\n     */\n    private _loaded: boolean = false;\n\n    /**\n     * 贴图宽度\n     */\n    private _width: number = 0;\n\n    /**\n     * 贴图高度\n     */\n    private _height: number = 0;\n\n    /**\n     * 创建贴图对象\n     */\n    public constructor() {\n        this.id = GETID();\n    }\n\n    /** 单一贴图版本，每个 Render 独立记录已上传版本。 */\n    public get version(): number { return this._version; }\n    /** 贴图来源地址；修改地址本身不会自动下载。 */\n    public get url(): string | null { return this._url; }\n    /** @param value 来源地址，下载使用 load */\n    public set url(value: string | null) {\n        if (this._url === value) return;\n        this._url = value;\n        this.updateVersion();\n    }\n    /** 当前浏览器图片源。 */\n    public get source(): TextureSource | null { return this._source; }\n    /** @param value 新图片源；同步更新宽高和 loaded，null 清空 */\n    public set source(value: TextureSource | null) {\n        if (this._source === value) return;\n        if (value === null) this.clearSource();\n        else this.setSource(value, this._url);\n    }\n    /** 当前图片是否可上传。 */\n    public get loaded(): boolean { return this._loaded; }\n    /** @param value 是否已加载；正常情况由 setSource / clearSource 自动维护 */\n    public set loaded(value: boolean) {\n        if (this._loaded === value) return;\n        this._loaded = value;\n        this.updateVersion();\n    }\n    /** 图片宽度，单位为源像素。 */\n    public get width(): number { return this._width; }\n    /** @param value 源像素宽度，必须为非负整数 */\n    public set width(value: number) {\n        if (!Number.isInteger(value) || value < 0) throw new RangeError(\"Texture width must be a non-negative integer.\");\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 (!Number.isInteger(value) || value < 0) throw new RangeError(\"Texture height must be a non-negative integer.\");\n        if (this._height === value) return;\n        this._height = value;\n        this.updateVersion();\n    }\n\n    /**\n     * 关联贴图消费者；多个分区可以共享同一 Texture。\n     * @param subscriber 消费者，重复 add 不会重复通知\n     */\n    public add(subscriber: TextureSubscriber): void {\n        this._subscribers.add(subscriber);\n    }\n    /**\n     * 解绑贴图消费者，不销毁图片源和任何 Render 的缓存。\n     * @param subscriber 需要解绑的消费者\n     */\n    public delete(subscriber: TextureSubscriber): void {\n        this._subscribers.delete(subscriber);\n    }\n\n    /** 原地修改图片像素后手动递增版本并通知；各 Render 独立消费，不存在清除版本操作。 */\n    public updateVersion(): void {\n        this._version++;\n        for (const subscriber of [...this._subscribers]) subscriber.onTextureChange(this);\n    }\n\n    /**\n     * 设置贴图源数据\n     * @param source 贴图源数据\n     * @param url 贴图来源地址\n     * @returns 当前贴图对象\n     */\n    public setSource(source: TextureSource, url: string | null = null): this {\n        // 原子提交：消费者不会看到“新图片配旧宽高”的中间状态，只通知一次。\n        this._url = url;\n        this._source = source;\n        this._loaded = true;\n        this._width = GetTextureWidth(source);\n        this._height = GetTextureHeight(source);\n        this.updateVersion();\n\n        return this;\n    }\n\n    /**\n     * 清空贴图源数据\n     * @returns 当前贴图对象\n     */\n    public clearSource(): this {\n        this._url = null;\n        this._source = null;\n        this._loaded = false;\n        this._width = 0;\n        this._height = 0;\n        this.updateVersion();\n\n        return this;\n    }\n\n    /**\n     * 从地址加载贴图\n     * @param url 贴图地址\n     * @returns 当前贴图对象\n     */\n    public async load(url: string): Promise<this> {\n        const image = await LoadImage(url);\n\n        return this.setSource(image, url);\n    }\n}\n\n/**\n * 加载图片元素\n * @param url 图片地址\n * @returns 图片元素\n */\nconst LoadImage = (url: string): Promise<HTMLImageElement> => {\n    return new Promise((resolve, reject) => {\n        const image = new Image();\n\n        image.onload = () => {\n            resolve(image);\n        };\n\n        image.onerror = () => {\n            reject(new Error(`Texture load failed: ${url}`));\n        };\n\n        image.src = url;\n    });\n};\n\n/**\n * 获取贴图宽度\n * @param source 贴图源数据\n * @returns 贴图宽度\n */\nconst GetTextureWidth = (source: TextureSource): number => {\n    if (\"naturalWidth\" in source) {\n        return source.naturalWidth;\n    }\n\n    return source.width;\n};\n\n/**\n * 获取贴图高度\n * @param source 贴图源数据\n * @returns 贴图高度\n */\nconst GetTextureHeight = (source: TextureSource): number => {\n    if (\"naturalHeight\" in source) {\n        return source.naturalHeight;\n    }\n\n    return source.height;\n};\n\nexport default Texture;\nexport type { TextureLike, TextureSource, TextureSubscriber };\nexport { default as TextureLayers } from \"./Layers\";\nexport type { TextureResource } from \"./Layers\";\n"],"mappings":";;;;;;;;;AA6BA,IAAM,UAAN,MAAqC;;;;CAIjC;;;;CAKA,OAA+B;CAE/B,WAA2B;CAC3B,+BAAgC,IAAI,IAAuB;;;;CAK3D,OAA8B;;;;CAK9B,UAAwC;;;;CAKxC,UAA2B;;;;CAK3B,SAAyB;;;;CAKzB,UAA0B;;;;CAK1B,cAAqB;EACjB,KAAK,KAAK,MAAM;CACpB;;CAGA,IAAW,UAAkB;EAAE,OAAO,KAAK;CAAU;;CAErD,IAAW,MAAqB;EAAE,OAAO,KAAK;CAAM;;CAEpD,IAAW,IAAI,OAAsB;EACjC,IAAI,KAAK,SAAS,OAAO;EACzB,KAAK,OAAO;EACZ,KAAK,cAAc;CACvB;;CAEA,IAAW,SAA+B;EAAE,OAAO,KAAK;CAAS;;CAEjE,IAAW,OAAO,OAA6B;EAC3C,IAAI,KAAK,YAAY,OAAO;EAC5B,IAAI,UAAU,MAAM,KAAK,YAAY;OAChC,KAAK,UAAU,OAAO,KAAK,IAAI;CACxC;;CAEA,IAAW,SAAkB;EAAE,OAAO,KAAK;CAAS;;CAEpD,IAAW,OAAO,OAAgB;EAC9B,IAAI,KAAK,YAAY,OAAO;EAC5B,KAAK,UAAU;EACf,KAAK,cAAc;CACvB;;CAEA,IAAW,QAAgB;EAAE,OAAO,KAAK;CAAQ;;CAEjD,IAAW,MAAM,OAAe;EAC5B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG,MAAM,IAAI,WAAW,+CAA+C;EAC/G,IAAI,KAAK,WAAW,OAAO;EAC3B,KAAK,SAAS;EACd,KAAK,cAAc;CACvB;;CAEA,IAAW,SAAiB;EAAE,OAAO,KAAK;CAAS;;CAEnD,IAAW,OAAO,OAAe;EAC7B,IAAI,CAAC,OAAO,UAAU,KAAK,KAAK,QAAQ,GAAG,MAAM,IAAI,WAAW,gDAAgD;EAChH,IAAI,KAAK,YAAY,OAAO;EAC5B,KAAK,UAAU;EACf,KAAK,cAAc;CACvB;;;;;CAMA,IAAW,YAAqC;EAC5C,KAAK,aAAa,IAAI,UAAU;CACpC;;;;;CAKA,OAAc,YAAqC;EAC/C,KAAK,aAAa,OAAO,UAAU;CACvC;;CAGA,gBAA6B;EACzB,KAAK;EACL,KAAK,MAAM,cAAc,CAAC,GAAG,KAAK,YAAY,GAAG,WAAW,gBAAgB,IAAI;CACpF;;;;;;;CAQA,UAAiB,QAAuB,MAAqB,MAAY;EAErE,KAAK,OAAO;EACZ,KAAK,UAAU;EACf,KAAK,UAAU;EACf,KAAK,SAAS,gBAAgB,MAAM;EACpC,KAAK,UAAU,iBAAiB,MAAM;EACtC,KAAK,cAAc;EAEnB,OAAO;CACX;;;;;CAMA,cAA2B;EACvB,KAAK,OAAO;EACZ,KAAK,UAAU;EACf,KAAK,UAAU;EACf,KAAK,SAAS;EACd,KAAK,UAAU;EACf,KAAK,cAAc;EAEnB,OAAO;CACX;;;;;;CAOA,MAAa,KAAK,KAA4B;EAC1C,MAAM,QAAQ,MAAM,UAAU,GAAG;EAEjC,OAAO,KAAK,UAAU,OAAO,GAAG;CACpC;AACJ;;;;;;AAOA,IAAM,aAAa,QAA2C;CAC1D,OAAO,IAAI,SAAS,SAAS,WAAW;EACpC,MAAM,QAAQ,IAAI,MAAM;EAExB,MAAM,eAAe;GACjB,QAAQ,KAAK;EACjB;EAEA,MAAM,gBAAgB;GAClB,uBAAO,IAAI,MAAM,wBAAwB,KAAK,CAAC;EACnD;EAEA,MAAM,MAAM;CAChB,CAAC;AACL;;;;;;AAOA,IAAM,mBAAmB,WAAkC;CACvD,IAAI,kBAAkB,QAClB,OAAO,OAAO;CAGlB,OAAO,OAAO;AAClB;;;;;;AAOA,IAAM,oBAAoB,WAAkC;CACxD,IAAI,mBAAmB,QACnB,OAAO,OAAO;CAGlB,OAAO,OAAO;AAClB"}

package/lib/global-types.d.ts

@@ -0,0 +1,8 @@
+import type { ObjectNodeLike } from "./Object/index";
+import type { Rect2dLike } from "./Geometry/Rect2d";
+import type { Poly2DLike } from "./Geometry/Poly2D";
+import type { BaseMaterialLike } from "./Material/baseMaterial";
+type AddObject = ObjectNodeLike;
+type Geometry2d = Rect2dLike | Poly2DLike;
+type Material2d = BaseMaterialLike;
+export type { AddObject, Geometry2d, Material2d };

package/lib/index.d.ts

@@ -0,0 +1,43 @@
+/// <reference types="@webgpu/types" preserve="true" />
+import Camera from "./Camera";
+import Color from "./Color";
+import Style from "./Style";
+import Geo from "./Geometry/Geo";
+import Rect2d from "./Geometry/Rect2d";
+import Poly2D from "./Geometry/Poly2D";
+import Group from "./Group";
+import IMesh from "./IMesh";
+import BaseMaterial from "./Material/baseMaterial";
+import Material from "./Material/Material";
+import Mesh from "./Mesh";
+import ObjectNode from "./Object";
+import Render from "./Render";
+import Scene from "./Scene";
+import Raws from "./Raws";
+import Texture from "./Texture";
+import { GETID } from "./ID";
+export { BaseMaterial, Camera, Color, Style, Geo, GETID, Group, IMesh, Material, Mesh, ObjectNode, Rect2d, Poly2D, Render, Scene, Raws, Texture, };
+export { BufferManager, DepthManager, DevelopmentValidator, DestroyManager, DrawCallManager, InitCamera, InitScene, MatrixUpdate, PipelineManager, SamplerManager, TextureManager, } from "./Render";
+export type { CameraBuffersLike, CameraLike } from "./Camera";
+export type { BorderAlign, GeoBuffersLike, GeoData, GeoPartDataLike, GeometrySubscriber } from "./Geometry/Geo";
+export type { Rect2dLike, Rect2dOptions } from "./Geometry/Rect2d";
+export type { Poly2DLike, Poly2DOptions } from "./Geometry/Poly2D";
+export { JoinStyle } from "./Style";
+export type { JoinType } from "./Style";
+export type { GroupLike } from "./Group";
+export type { BaseMaterialLike } from "./Material/baseMaterial";
+export type { MaterialBuffersLike, MaterialChange, MaterialChangeKind, MaterialLike, MaterialSubscriber, PixelAligned, ShadersLike } from "./Material/Material";
+export type { MeshLike } from "./Mesh";
+export type { AddObject, Geometry2d, Material2d } from "./global-types";
+export type { ObjectNodeLike } from "./Object";
+export type { BufferManagerLike, DepthTextureLike, MeshDepthBufferLike, DevelopmentValidatorLike, DestroyManagerLike, DrawCallManagerLike, GeometryBufferPartLike, GeometryBufferLike, GPUTextureResourceLike, MeshMatrixBufferLike, MeshStyleBufferLike, PipelineBuffersLike, PipelineLike, PipelineManagerLike, PipelineTemplateLike, RenderLike, RenderMode, SamplerManagerLike, SceneResourcesLike, TextureManagerLike, } from "./Render";
+export type { DrawList, GeometryList, MaterialList, SceneLike, TextureList } from "./Scene";
+export type { TextureLike, TextureSource, TextureSubscriber } from "./Texture";
+export { SolidStyle, WireframeStyle, EdgeStyle, PointsStyle, WriteStyleData, STYLE_STRIDE } from "./Style";
+export type { ColorSubscriber } from "./Color";
+export type { StyleArea, StyleChange, StyleSubscriber, PartSubscriber } from "./Style";
+export { Raw } from "./Raws";
+export type { RawOptions, RawChange, RawSubscriber } from "./Raws";
+export type { IMeshOptions } from "./IMesh";
+export { default as TextureLayers } from "./Texture/Layers";
+export type { TextureResource } from "./Texture/Layers";

package/lib/index.js

@@ -0,0 +1,34 @@
+import { GETID } from "./ID.js";
+import ObjectNode from "./Object/index.js";
+import Camera from "./Camera/index.js";
+import Color from "./Color/index.js";
+import SolidStyle from "./Style/SolidStyle.js";
+import WireframeStyle from "./Style/WireframeStyle.js";
+import EdgeStyle from "./Style/EdgeStyle.js";
+import PointsStyle from "./Style/PointsStyle.js";
+import JoinStyle from "./Style/JoinStyle.js";
+import { STYLE_STRIDE, WriteStyleData } from "./Style/WriteStyleData.js";
+import Style from "./Style/index.js";
+import Geo from "./Geometry/Geo.js";
+import Rect2d from "./Geometry/Rect2d.js";
+import Poly2D from "./Geometry/Poly2D.js";
+import Group from "./Group/index.js";
+import Mesh from "./Mesh/index.js";
+import Raws, { Raw } from "./Raws/index.js";
+import TextureLayers from "./Texture/Layers.js";
+import IMesh from "./IMesh/index.js";
+import Material from "./Material/Material.js";
+import BaseMaterial from "./Material/baseMaterial.js";
+import DepthManager from "./Render/DepthManager.js";
+import DevelopmentValidator from "./Render/DevelopmentValidator.js";
+import BufferManager from "./Render/BufferManager.js";
+import DestroyManager from "./Render/DestroyManager.js";
+import SamplerManager from "./Render/SamplerManager.js";
+import DrawCallManager from "./Render/DrawCallManager.js";
+import TextureManager from "./Render/TextureManager.js";
+import PipelineManager from "./Render/PipelineManager.js";
+import { InitCamera, InitScene, MatrixUpdate } from "./Render/SceneUpdate.js";
+import Render from "./Render/index.js";
+import Scene from "./Scene/index.js";
+import Texture from "./Texture/index.js";
+export { BaseMaterial, BufferManager, Camera, Color, DepthManager, DestroyManager, DevelopmentValidator, DrawCallManager, EdgeStyle, GETID, Geo, Group, IMesh, InitCamera, InitScene, JoinStyle, Material, MatrixUpdate, Mesh, ObjectNode, PipelineManager, PointsStyle, Poly2D, Raw, Raws, Rect2d, Render, STYLE_STRIDE, SamplerManager, Scene, SolidStyle, Style, Texture, TextureLayers, TextureManager, WireframeStyle, WriteStyleData };