@carbonenginejs/runtime-resource 0.12.2 → 0.13.0

package/dist/resource/texture/CjsTextureArrayResParameterProxy.js

@@ -1,179 +1,179 @@
-import { CjsEventEmitter } from '@carbonenginejs/runtime-utils/model';
-
-/**
- * `CjsTextureArrayRes`-owned parameter facade for one array layer that mirrors
- * the public path API while delegating storage, invalidation, readiness, and
- * adapter ownership to its parent, carrying no shader metadata or backend
- * objects itself.
- *
- * Engines bridge public parameters into it; it does not replace persisted
- * parameter entries or their individual source resources.
- */
-class CjsTextureArrayResParameterProxy extends CjsEventEmitter {
-  #parent;
-  #layer;
-  #name;
-
-  /** Creates a CjsTextureArrayResParameterProxy with caller-provided initial state. */
-  constructor(parent, layer, options = {}) {
-    super();
-    if (!parent || typeof parent.SetLayerResourcePath !== "function") {
-      throw new TypeError("CjsTextureArrayResParameterProxy requires a CjsTextureArrayRes-compatible parent.");
-    }
-    if (!Number.isInteger(layer) || layer < 0) {
-      throw new RangeError("CjsTextureArrayResParameterProxy layer must be a non-negative integer.");
-    }
-    this.#parent = parent;
-    this.#layer = layer;
-    this.#name = options.name === undefined ? "" : String(options.name);
-  }
-
-  /**
-   * Returns the resource path represented by this texture layer proxy for the
-   * texture parameter proxy.
-   */
-  get resourcePath() {
-    return this.GetResourcePath();
-  }
-
-  /** The aggregate texture resource used by the shader. */
-  get textureRes() {
-    return this.#parent;
-  }
-
-  /** Compatibility alias for textureRes. */
-  get res() {
-    return this.#parent;
-  }
-
-  /** Compatibility alias used by Carbon-shaped texture parameters. */
-  get resource() {
-    return this.#parent;
-  }
-
-  /** Updates the resource path exposed by the current texture parameter proxy. */
-  set resourcePath(value) {
-    this.SetResourcePath(value);
-  }
-
-  /**
-   * Returns the public parameter name represented by this texture layer proxy
-   * for the texture parameter proxy.
-   */
-  get name() {
-    return this.#name;
-  }
-
-  /** Updates the name exposed by the current texture parameter proxy. */
-  set name(value) {
-    this.SetParameterName(value);
-  }
-
-  /** Returns parent from the current texture parameter proxy. */
-  GetParent() {
-    return this.#parent;
-  }
-
-  /** Returns layer index from the current texture parameter proxy. */
-  GetLayerIndex() {
-    return this.#layer;
-  }
-
-  /** Returns parameter name from the current texture parameter proxy. */
-  GetParameterName() {
-    return this.#name;
-  }
-
-  /** Updates parameter name in the current texture parameter proxy. */
-  SetParameterName(value) {
-    const next = value === null || value === undefined ? "" : String(value);
-    if (next === this.#name) return false;
-    const previous = this.#name;
-    this.#name = next;
-    this.EmitEvent("changed", this, "name", next, previous);
-    return true;
-  }
-
-  /** Returns resource path from the current texture parameter proxy. */
-  GetResourcePath() {
-    return this.#parent.GetLayerResourcePath(this.#layer);
-  }
-
-  /** Updates resource path in the current texture parameter proxy. */
-  SetResourcePath(value) {
-    const previous = this.GetResourcePath();
-    if (!this.#parent.SetLayerResourcePath(this.#layer, value)) return false;
-    this.EmitEvent("changed", this, "resourcepath", this.GetResourcePath(), previous);
-    return true;
-  }
-
-  /** Returns value from the current texture parameter proxy. */
-  GetValue() {
-    return this.GetResourcePath();
-  }
-
-  /** Updates value in the current texture parameter proxy. */
-  SetValue(value) {
-    if (value === undefined) return false;
-    return this.SetResourcePath(value);
-  }
-
-  /** Compares value with the current texture parameter proxy value. */
-  EqualsValue(value) {
-    return String(value ?? "").trim().replace(/\\/gu, "/").replace(/\/+/gu, "/").toLowerCase() === this.GetResourcePath();
-  }
-
-  /** Return the aggregate texture resource used by the shader binding. */
-  GetResource() {
-    return this.#parent;
-  }
-
-  /** Return the optional resolved source resource for this layer. */
-  GetSourceResource() {
-    return this.#parent.GetLayerResource(this.#layer);
-  }
-
-  /** Updates source resource in the current texture parameter proxy. */
-  SetSourceResource(resource) {
-    const previous = this.GetSourceResource();
-    if (!this.#parent.SetLayerResource(this.#layer, resource)) return false;
-    this.EmitEvent("changed", this, "sourceresource", this.GetSourceResource(), previous);
-    return true;
-  }
-
-  /** Updates resource in the current texture parameter proxy. */
-  SetResource(resource) {
-    return this.SetSourceResource(resource);
-  }
-
-  /** Invalidate this layer after an in-place source content revision. */
-  Touch() {
-    this.#parent.TouchLayer(this.#layer);
-    this.EmitEvent("changed", this, "sourcerevision", this.GetSourceResource());
-    return this;
-  }
-
-  /** Returns resources from the current texture parameter proxy. */
-  GetResources(out = []) {
-    if (!out.includes(this.#parent)) out.push(this.#parent);
-    return out;
-  }
-
-  /** Reports whether the current texture parameter proxy satisfies prepared. */
-  IsPrepared() {
-    return this.#parent.IsPrepared();
-  }
-
-  /** Reports whether the current texture parameter proxy satisfies good. */
-  IsGood() {
-    return this.#parent.IsGood();
-  }
-
-  /** Reads y from the current texture parameter proxy. */
-  Ready(options = {}) {
-    return this.#parent.Ready(options);
-  }
-}
-
-export { CjsTextureArrayResParameterProxy };
-//# sourceMappingURL=CjsTextureArrayResParameterProxy.js.map
+import { CjsEventEmitter } from '@carbonenginejs/runtime-utils/model';
+
+/**
+ * `CjsTextureArrayRes`-owned parameter facade for one array layer that mirrors
+ * the public path API while delegating storage, invalidation, readiness, and
+ * adapter ownership to its parent, carrying no shader metadata or backend
+ * objects itself.
+ *
+ * Engines bridge public parameters into it; it does not replace persisted
+ * parameter entries or their individual source resources.
+ */
+class CjsTextureArrayResParameterProxy extends CjsEventEmitter {
+  #parent;
+  #layer;
+  #name;
+
+  /** Creates a CjsTextureArrayResParameterProxy with caller-provided initial state. */
+  constructor(parent, layer, options = {}) {
+    super();
+    if (!parent || typeof parent.SetLayerResourcePath !== "function") {
+      throw new TypeError("CjsTextureArrayResParameterProxy requires a CjsTextureArrayRes-compatible parent.");
+    }
+    if (!Number.isInteger(layer) || layer < 0) {
+      throw new RangeError("CjsTextureArrayResParameterProxy layer must be a non-negative integer.");
+    }
+    this.#parent = parent;
+    this.#layer = layer;
+    this.#name = options.name === undefined ? "" : String(options.name);
+  }
+
+  /**
+   * Returns the resource path represented by this texture layer proxy for the
+   * texture parameter proxy.
+   */
+  get resourcePath() {
+    return this.GetResourcePath();
+  }
+
+  /** The aggregate texture resource used by the shader. */
+  get textureRes() {
+    return this.#parent;
+  }
+
+  /** Compatibility alias for textureRes. */
+  get res() {
+    return this.#parent;
+  }
+
+  /** Compatibility alias used by Carbon-shaped texture parameters. */
+  get resource() {
+    return this.#parent;
+  }
+
+  /** Updates the resource path exposed by the current texture parameter proxy. */
+  set resourcePath(value) {
+    this.SetResourcePath(value);
+  }
+
+  /**
+   * Returns the public parameter name represented by this texture layer proxy
+   * for the texture parameter proxy.
+   */
+  get name() {
+    return this.#name;
+  }
+
+  /** Updates the name exposed by the current texture parameter proxy. */
+  set name(value) {
+    this.SetParameterName(value);
+  }
+
+  /** Returns parent from the current texture parameter proxy. */
+  GetParent() {
+    return this.#parent;
+  }
+
+  /** Returns layer index from the current texture parameter proxy. */
+  GetLayerIndex() {
+    return this.#layer;
+  }
+
+  /** Returns parameter name from the current texture parameter proxy. */
+  GetParameterName() {
+    return this.#name;
+  }
+
+  /** Updates parameter name in the current texture parameter proxy. */
+  SetParameterName(value) {
+    const next = value === null || value === undefined ? "" : String(value);
+    if (next === this.#name) return false;
+    const previous = this.#name;
+    this.#name = next;
+    this.EmitEvent("changed", this, "name", next, previous);
+    return true;
+  }
+
+  /** Returns resource path from the current texture parameter proxy. */
+  GetResourcePath() {
+    return this.#parent.GetLayerResourcePath(this.#layer);
+  }
+
+  /** Updates resource path in the current texture parameter proxy. */
+  SetResourcePath(value) {
+    const previous = this.GetResourcePath();
+    if (!this.#parent.SetLayerResourcePath(this.#layer, value)) return false;
+    this.EmitEvent("changed", this, "resourcepath", this.GetResourcePath(), previous);
+    return true;
+  }
+
+  /** Returns value from the current texture parameter proxy. */
+  GetValue() {
+    return this.GetResourcePath();
+  }
+
+  /** Updates value in the current texture parameter proxy. */
+  SetValue(value) {
+    if (value === undefined) return false;
+    return this.SetResourcePath(value);
+  }
+
+  /** Compares value with the current texture parameter proxy value. */
+  EqualsValue(value) {
+    return String(value ?? "").trim().replace(/\\/gu, "/").replace(/\/+/gu, "/").toLowerCase() === this.GetResourcePath();
+  }
+
+  /** Return the aggregate texture resource used by the shader binding. */
+  GetResource() {
+    return this.#parent;
+  }
+
+  /** Return the optional resolved source resource for this layer. */
+  GetSourceResource() {
+    return this.#parent.GetLayerResource(this.#layer);
+  }
+
+  /** Updates source resource in the current texture parameter proxy. */
+  SetSourceResource(resource) {
+    const previous = this.GetSourceResource();
+    if (!this.#parent.SetLayerResource(this.#layer, resource)) return false;
+    this.EmitEvent("changed", this, "sourceresource", this.GetSourceResource(), previous);
+    return true;
+  }
+
+  /** Updates resource in the current texture parameter proxy. */
+  SetResource(resource) {
+    return this.SetSourceResource(resource);
+  }
+
+  /** Invalidate this layer after an in-place source content revision. */
+  Touch() {
+    this.#parent.TouchLayer(this.#layer);
+    this.EmitEvent("changed", this, "sourcerevision", this.GetSourceResource());
+    return this;
+  }
+
+  /** Returns resources from the current texture parameter proxy. */
+  GetResources(out = []) {
+    if (!out.includes(this.#parent)) out.push(this.#parent);
+    return out;
+  }
+
+  /** Reports whether the current texture parameter proxy satisfies prepared. */
+  IsPrepared() {
+    return this.#parent.IsPrepared();
+  }
+
+  /** Reports whether the current texture parameter proxy satisfies good. */
+  IsGood() {
+    return this.#parent.IsGood();
+  }
+
+  /** Reads y from the current texture parameter proxy. */
+  Ready(options = {}) {
+    return this.#parent.Ready(options);
+  }
+}
+
+export { CjsTextureArrayResParameterProxy };
+//# sourceMappingURL=CjsTextureArrayResParameterProxy.js.map

package/dist/resource/texture/Tr2ImageRes.js

@@ -1,120 +1,120 @@
-import { CjsSchema, carbon, impl, type, io } from '@carbonenginejs/runtime-utils/schema';
-import { CjsResource } from '../CjsResource.js';
-import { validateRgbaPayload } from '../../format/payloadContract.js';
-import { validateResourcePayload } from '../resourceBoundary.js';
-
-// Source: trinity/trinity/Resources/Tr2ImageRes.h
-// Source: trinity/trinity/Resources/Tr2ImageRes.cpp
-// Source: trinity/trinity/Resources/Tr2ImageRes_Blue.cpp
-
-/**
- * Tr2ImageRes resource record.
- *
- * Carbon treats this as image payload data. Engine-gpu decides whether it ever
- * becomes device texture state.
- */
-class Tr2ImageRes extends CjsResource {
-  width = 0;
-  height = 0;
-
-  /** Creates a Tr2ImageRes with caller-provided initial state. */
-  constructor(values = null) {
-    super();
-    this.SetValues(values || {}, {
-      markDirty: false,
-      skipUpdate: true,
-      skipEvents: true
-    });
-  }
-
-  /**
-   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.
-   *
-   * @param {object|null} payload
-   * @param {object|null} options
-   * @returns {Tr2ImageRes}
-   */
-  SetPayload(payload = null, options = null) {
-    if (payload === null) {
-      super.SetPayload(null);
-      return this;
-    }
-    validateResourcePayload("Tr2ImageRes", payload, validateRgbaPayload);
-    const values = {
-      ...(options || {})
-    };
-    values.width = payload.width;
-    values.height = payload.height;
-    super.SetPayload(payload);
-    this.SetValues(values);
-    return this;
-  }
-
-  /**
-   * Return image width in pixels.
-   *
-   * @returns {number}
-   */
-  GetWidth() {
-    return this.width || 0;
-  }
-
-  /**
-   * Return image height in pixels.
-   *
-   * @returns {number}
-   */
-  GetHeight() {
-    return this.height || 0;
-  }
-
-  /**
-   * Read pixel color from payload metadata when a simple pixel accessor exists.
-   *
-   * @param {number} x
-   * @param {number} y
-   * @returns {*}
-   */
-  GetPixelColor(x = 0, y = 0) {
-    const payload = this.GetPayload();
-    if (!payload || !Number.isInteger(x) || !Number.isInteger(y) || x < 0 || y < 0 || x >= payload.width || y >= payload.height) return null;
-    const elementsPerRow = payload.strideBytes / payload.data.BYTES_PER_ELEMENT;
-    const offset = y * elementsPerRow + x * 4;
-    return Array.from(payload.data.subarray(offset, offset + 4));
-  }
-
-  /**
-   * Return true when a pixel alpha channel is absent or non-zero.
-   *
-   * @param {number} x
-   * @param {number} y
-   * @returns {boolean}
-   */
-  IsPixelOpaque(x = 0, y = 0) {
-    const color = this.GetPixelColor(x, y);
-    if (!Array.isArray(color)) return false;
-    return color.length < 4 || color[3] > 0;
-  }
-  static payload = "image";
-}
-
-// Declared as data rather than with decorators, so the resource tree loads from
-// source without a transform. Field order is key order, and GetValues() exports
-// in that order.
-CjsSchema.define(Tr2ImageRes, {
-  className: "Tr2ImageRes",
-  family: "resources",
-  fields: {
-    width: [type.uint32, io.persist],
-    height: [type.uint32, io.persist]
-  },
-  methods: {
-    GetWidth: [carbon.method, impl.adapted],
-    GetHeight: [carbon.method, impl.adapted],
-    GetPixelColor: [carbon.method, impl.adapted],
-    IsPixelOpaque: [carbon.method, impl.adapted]
-  }
-});
-
-export { Tr2ImageRes };
-//# sourceMappingURL=Tr2ImageRes.js.map
+import { CjsSchema, carbon, impl, type, io } from '@carbonenginejs/runtime-utils/schema';
+import { CjsResource } from '../CjsResource.js';
+import { validateRgbaPayload } from '../../format/payloadContract.js';
+import { validateResourcePayload } from '../resourceBoundary.js';
+
+// Source: trinity/trinity/Resources/Tr2ImageRes.h
+// Source: trinity/trinity/Resources/Tr2ImageRes.cpp
+// Source: trinity/trinity/Resources/Tr2ImageRes_Blue.cpp
+
+/**
+ * Tr2ImageRes resource record.
+ *
+ * Carbon treats this as image payload data. Engine-gpu decides whether it ever
+ * becomes device texture state.
+ */
+class Tr2ImageRes extends CjsResource {
+  width = 0;
+  height = 0;
+
+  /** Creates a Tr2ImageRes with caller-provided initial state. */
+  constructor(values = null) {
+    super();
+    this.SetValues(values || {}, {
+      markDirty: false,
+      skipUpdate: true,
+      skipEvents: true
+    });
+  }
+
+  /**
+   * Attach a plain canonical RGBA payload and mirror Carbon-exposed metadata.
+   *
+   * @param {object|null} payload
+   * @param {object|null} options
+   * @returns {Tr2ImageRes}
+   */
+  SetPayload(payload = null, options = null) {
+    if (payload === null) {
+      super.SetPayload(null);
+      return this;
+    }
+    validateResourcePayload("Tr2ImageRes", payload, validateRgbaPayload);
+    const values = {
+      ...(options || {})
+    };
+    values.width = payload.width;
+    values.height = payload.height;
+    super.SetPayload(payload);
+    this.SetValues(values);
+    return this;
+  }
+
+  /**
+   * Return image width in pixels.
+   *
+   * @returns {number}
+   */
+  GetWidth() {
+    return this.width || 0;
+  }
+
+  /**
+   * Return image height in pixels.
+   *
+   * @returns {number}
+   */
+  GetHeight() {
+    return this.height || 0;
+  }
+
+  /**
+   * Read pixel color from payload metadata when a simple pixel accessor exists.
+   *
+   * @param {number} x
+   * @param {number} y
+   * @returns {*}
+   */
+  GetPixelColor(x = 0, y = 0) {
+    const payload = this.GetPayload();
+    if (!payload || !Number.isInteger(x) || !Number.isInteger(y) || x < 0 || y < 0 || x >= payload.width || y >= payload.height) return null;
+    const elementsPerRow = payload.strideBytes / payload.data.BYTES_PER_ELEMENT;
+    const offset = y * elementsPerRow + x * 4;
+    return Array.from(payload.data.subarray(offset, offset + 4));
+  }
+
+  /**
+   * Return true when a pixel alpha channel is absent or non-zero.
+   *
+   * @param {number} x
+   * @param {number} y
+   * @returns {boolean}
+   */
+  IsPixelOpaque(x = 0, y = 0) {
+    const color = this.GetPixelColor(x, y);
+    if (!Array.isArray(color)) return false;
+    return color.length < 4 || color[3] > 0;
+  }
+  static payload = "image";
+}
+
+// Declared as data rather than with decorators, so the resource tree loads from
+// source without a transform. Field order is key order, and GetValues() exports
+// in that order.
+CjsSchema.define(Tr2ImageRes, {
+  className: "Tr2ImageRes",
+  family: "resources",
+  fields: {
+    width: [type.uint32, io.persist],
+    height: [type.uint32, io.persist]
+  },
+  methods: {
+    GetWidth: [carbon.method, impl.adapted],
+    GetHeight: [carbon.method, impl.adapted],
+    GetPixelColor: [carbon.method, impl.adapted],
+    IsPixelOpaque: [carbon.method, impl.adapted]
+  }
+});
+
+export { Tr2ImageRes };
+//# sourceMappingURL=Tr2ImageRes.js.map