@carbonenginejs/runtime-resource 0.1.0

package/dist/texture/CjsTextureArrayRes.js

@@ -0,0 +1,406 @@
+import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
+import { type } from '@carbonenginejs/core-types/schema';
+import { CjsResource as _CjsResource } from '../CjsResource.js';
+import { normalizeResourcePath } from '../resourcePath.js';
+import { CjsTextureParameterProxy } from './CjsTextureParameterProxy.js';
+
+let _initClass;
+
+/**
+ * Mutable runtime aggregate for an ordered texture-array request.
+ *
+ * Private engine-bridge layer proxies only invalidate this parent. A resource
+ * manager or engine scheduler consumes the coalesced update on a later frame
+ * and prepares the corresponding immutable/cached texture-array payload.
+ */
+let _CjsTextureArrayRes;
+new class extends _identity {
+  static [class CjsTextureArrayRes extends _CjsResource {
+    static {
+      [_CjsTextureArrayRes, _initClass] = _applyDecs2311(this, [type.define({
+        className: "CjsTextureArrayRes",
+        family: "resource"
+      })], [], 0, void 0, _CjsResource).c;
+    }
+    #layers = [];
+    #dirtyLayers = new Set();
+    #requestedRevision = 0;
+    #preparedRevision = 0;
+    #updateScheduled = false;
+    #topologyChanged = false;
+    #inFlightRequests = new Map();
+    #readyWaiters = [];
+    #failedRevision = 0;
+    #failedError = null;
+    #updateScheduler = null;
+    #updateHandler = null;
+    constructor(values = null) {
+      const options = values && typeof values === "object" && !Array.isArray(values) ? values : {};
+      const resourceValues = {
+        ...options
+      };
+      delete resourceValues.layers;
+      delete resourceValues.paths;
+      delete resourceValues.layerCount;
+      delete resourceValues.layerNames;
+      delete resourceValues.updateScheduler;
+      delete resourceValues.updateHandler;
+      super(resourceValues);
+      if (options.updateScheduler) this.SetUpdateScheduler(options.updateScheduler);
+      if (options.updateHandler) this.SetUpdateHandler(options.updateHandler);
+      const paths = options.layers || options.paths;
+      if (paths !== undefined) {
+        this.SetLayerResourcePaths(paths, options.layerNames);
+      } else if (options.layerCount !== undefined) {
+        this.SetLayerCount(options.layerCount, options.layerNames);
+      }
+    }
+    GetLayerCount() {
+      return this.#layers.length;
+    }
+    SetLayerCount(value, names = null) {
+      const count = Number(value);
+      if (!Number.isInteger(count) || count < 1) {
+        throw new RangeError("CjsTextureArrayRes layer count must be a positive integer.");
+      }
+      if (count === this.#layers.length) {
+        this.#SetLayerNames(names);
+        return false;
+      }
+      const previousCount = this.#layers.length;
+      if (count < previousCount) {
+        this.#layers.length = count;
+      } else {
+        for (let layer = previousCount; layer < count; layer++) {
+          this.#layers.push(this.#CreateLayer(layer, names?.[layer]));
+        }
+      }
+      this.#SetLayerNames(names);
+      this.#InvalidateRange(count, true);
+      return true;
+    }
+    GetLayerParameter(layer) {
+      return this.#GetLayer(layer).proxy;
+    }
+    GetLayerParameters(out = []) {
+      for (const layer of this.#layers) out.push(layer.proxy);
+      return out;
+    }
+    GetLayerResourcePath(layer) {
+      return this.#GetLayer(layer).path;
+    }
+    GetLayerResourcePaths(out = []) {
+      for (const layer of this.#layers) out.push(layer.path);
+      return out;
+    }
+    SetLayerResourcePath(layer, value) {
+      const record = this.#GetLayer(layer);
+      const path = normalizeResourcePath(value);
+      if (path === record.path) return false;
+      record.path = path;
+      record.resource = null;
+      this.#InvalidateLayer(layer);
+      return true;
+    }
+    SetLayerResourcePaths(values, names = null) {
+      if (!Array.isArray(values) || values.length === 0) {
+        throw new TypeError("CjsTextureArrayRes layers must be a non-empty array of resource paths.");
+      }
+      const paths = values.map(value => normalizeResourcePath(value && typeof value === "object" ? value.resourcePath ?? value.path ?? value.GetPath?.() ?? "" : value));
+      const topologyChanged = paths.length !== this.#layers.length;
+      let contentChanged = topologyChanged;
+      let namesChanged = false;
+      const changedLayers = new Set();
+      const next = [];
+      for (let layer = 0; layer < paths.length; layer++) {
+        const current = this.#layers[layer];
+        const name = names?.[layer] ?? current?.proxy?.GetParameterName?.() ?? "";
+        if (!current) {
+          next.push(this.#CreateLayer(layer, name, paths[layer]));
+        } else {
+          if (current.path !== paths[layer]) {
+            current.path = paths[layer];
+            current.resource = null;
+            contentChanged = true;
+            changedLayers.add(layer);
+          }
+          if (current.proxy.SetParameterName(name)) namesChanged = true;
+          next.push(current);
+        }
+      }
+      this.#layers = next;
+      if (topologyChanged) {
+        this.#InvalidateRange(paths.length, true);
+      } else if (contentChanged) {
+        this.#InvalidateLayers(changedLayers);
+      }
+      return contentChanged || namesChanged;
+    }
+    GetLayerResource(layer) {
+      return this.#GetLayer(layer).resource;
+    }
+    SetLayerResource(layer, resource) {
+      const record = this.#GetLayer(layer);
+      const next = resource ?? null;
+      if (record.resource === next) return false;
+      record.resource = next;
+      this.#InvalidateLayer(layer);
+      return true;
+    }
+
+    /** Invalidate a layer whose resolved resource changed without changing identity. */
+    TouchLayer(layer) {
+      this.#GetLayer(layer);
+      this.#InvalidateLayer(layer);
+      return this;
+    }
+
+    /** Invalidate every current layer, for example after an adapter generation loss. */
+    TouchAllLayers(options = {}) {
+      this.#InvalidateRange(this.#layers.length, !!options.topologyChanged);
+      return this;
+    }
+    GetRequestedRevision() {
+      return this.#requestedRevision;
+    }
+    GetPreparedRevision() {
+      return this.#preparedRevision;
+    }
+    NeedsUpdate() {
+      return this.#updateScheduled || this.#dirtyLayers.size > 0 || this.#preparedRevision < this.#requestedRevision;
+    }
+    GetDirtyLayers() {
+      return new Set(this.#dirtyLayers);
+    }
+    GetInFlightRevisions(out = []) {
+      for (const revision of this.#inFlightRequests.keys()) out.push(revision);
+      return out.sort((a, b) => a - b);
+    }
+    IsRevisionInFlight(revision) {
+      return this.#inFlightRequests.has(revision);
+    }
+    SetUpdateScheduler(schedule = null) {
+      if (schedule !== null && typeof schedule !== "function") {
+        throw new TypeError("CjsTextureArrayRes update scheduler must be a function or null.");
+      }
+      this.#updateScheduler = schedule;
+      if (schedule && this.#updateScheduled) schedule(this);
+      return this;
+    }
+    SetUpdateHandler(handler = null) {
+      if (handler !== null && typeof handler !== "function") {
+        throw new TypeError("CjsTextureArrayRes update handler must be a function or null.");
+      }
+      this.#updateHandler = handler;
+      return this;
+    }
+
+    /**
+     * Consume all proxy changes as one immutable request snapshot.
+     * A frame scheduler should call this at most once per parent per frame.
+     */
+    ConsumeUpdateRequest() {
+      if (!this.#updateScheduled && this.#dirtyLayers.size === 0) return null;
+      const request = Object.freeze({
+        revision: this.#requestedRevision,
+        paths: Object.freeze(this.GetLayerResourcePaths()),
+        resources: Object.freeze(this.#layers.map(layer => layer.resource)),
+        dirtyLayers: Object.freeze([...this.#dirtyLayers].sort((a, b) => a - b)),
+        topologyChanged: this.#topologyChanged
+      });
+      this.#dirtyLayers.clear();
+      this.#topologyChanged = false;
+      this.#updateScheduled = false;
+      this.#inFlightRequests.set(request.revision, request);
+      return request;
+    }
+
+    /** Requeue a consumed current request after cancellation, loss, or retryable failure. */
+    RetryUpdateRequest(revision = this.#requestedRevision) {
+      const request = this.#inFlightRequests.get(revision);
+      if (!request) return false;
+      this.#inFlightRequests.delete(revision);
+      if (revision !== this.#requestedRevision) return false;
+      if (this.#failedRevision === revision) {
+        this.#failedRevision = 0;
+        this.#failedError = null;
+      }
+      for (const layer of request.dirtyLayers) {
+        if (layer < this.#layers.length) this.#dirtyLayers.add(layer);
+      }
+      this.#topologyChanged ||= request.topologyChanged;
+      this.#ScheduleUpdate();
+      this.EmitEvent("revisionretry", this, revision);
+      return true;
+    }
+
+    /** Complete a consumed request as failed, optionally making it retryable. */
+    FailUpdateRequest(revision, error, options = {}) {
+      if (options.retry) return this.RetryUpdateRequest(revision);
+      if (!this.#inFlightRequests.has(revision)) return false;
+      this.#inFlightRequests.delete(revision);
+      if (revision !== this.#requestedRevision) return false;
+      const failure = error instanceof Error ? error : new Error(String(error ?? "Texture array preparation failed."));
+      this.#failedRevision = revision;
+      this.#failedError = failure;
+      if (this.#preparedRevision === 0) this.SetError(failure);
+      this.EmitEvent("revisionfailed", this, revision, failure);
+      this.#RejectReadyWaiters(revision, failure);
+      return true;
+    }
+
+    /** Run the registered update handler for the current coalesced frame request. */
+    Update(context = {}) {
+      const request = this.ConsumeUpdateRequest();
+      if (!request) return null;
+      this.EmitEvent("update", this, request, context);
+      return this.#updateHandler ? this.#updateHandler(this, request, context) : request;
+    }
+
+    /**
+     * Atomically publish an opaque adapter allocation with its prepared revision.
+     * The caller owns disposal of a successfully displaced allocation.
+     */
+    CommitPreparedAdapterRevision(revision, adapterKey, candidate, options = {}) {
+      if (!adapterKey) throw new TypeError("CjsTextureArrayRes adapter publication requires a key.");
+      if (candidate === null || candidate === undefined) {
+        throw new TypeError("CjsTextureArrayRes adapter publication requires a candidate allocation.");
+      }
+      const inFlight = this.#inFlightRequests.has(revision);
+      if (!inFlight || revision !== this.#requestedRevision) {
+        if (inFlight) this.#inFlightRequests.delete(revision);
+        if (options.destroyRejected !== false) DestroyAdapterValue(candidate);
+        return Object.freeze({
+          published: false,
+          revision,
+          displaced: null
+        });
+      }
+      const displaced = this.GetAdapterResource(adapterKey);
+      this.SetAdapterResource(adapterKey, candidate);
+      this.#preparedRevision = revision;
+      this.#failedRevision = 0;
+      this.#failedError = null;
+      this.#inFlightRequests.delete(revision);
+      for (const pendingRevision of this.#inFlightRequests.keys()) {
+        if (pendingRevision < revision) this.#inFlightRequests.delete(pendingRevision);
+      }
+      this.MarkPrepared();
+      this.EmitEvent("revisionprepared", this, revision, adapterKey, candidate);
+      this.#ResolveReadyWaiters(revision);
+      return Object.freeze({
+        published: true,
+        revision,
+        displaced: displaced === candidate ? null : displaced
+      });
+    }
+
+    /** Destroy an unusable adapter allocation and request a complete rebuild. */
+    HandleAdapterLoss(adapterKey, options = {}) {
+      if (!adapterKey) throw new TypeError("CjsTextureArrayRes adapter loss requires a key.");
+      const lost = this.GetAdapterResource(adapterKey);
+      if (this.HasAdapterResource(adapterKey)) this.DestroyAdapterResource(adapterKey, options);
+      this.#preparedRevision = 0;
+      if (this.#layers.length) this.#InvalidateRange(this.#layers.length, true);
+      if (this.state === _CjsResource.State.PREPARED) this.MarkPreparing();
+      this.EmitEvent("adapterlost", this, adapterKey, lost);
+      return lost;
+    }
+
+    /** Resolve when the generation requested at call time has been prepared. */
+    Ready() {
+      if (this.#requestedRevision === 0) {
+        const error = new Error("Texture array resource has no configured layers.");
+        error.code = "CJS_TEXTURE_ARRAY_UNCONFIGURED";
+        return Promise.reject(error);
+      }
+      const revision = this.#requestedRevision;
+      if (this.#preparedRevision >= revision && this.IsPrepared()) return Promise.resolve(this);
+      if (this.#failedRevision === revision) return Promise.reject(this.#failedError);
+      return new Promise((resolve, reject) => {
+        this.#readyWaiters.push({
+          revision,
+          resolve,
+          reject
+        });
+      });
+    }
+    #CreateLayer(layer, name = "", path = "") {
+      return {
+        path: normalizeResourcePath(path),
+        resource: null,
+        proxy: new CjsTextureParameterProxy(this, layer, {
+          name
+        })
+      };
+    }
+    #GetLayer(layer) {
+      if (!Number.isInteger(layer) || layer < 0 || layer >= this.#layers.length) {
+        throw new RangeError(`CjsTextureArrayRes layer ${layer} is out of range.`);
+      }
+      return this.#layers[layer];
+    }
+    #SetLayerNames(names) {
+      if (!names) return;
+      for (let layer = 0; layer < Math.min(names.length, this.#layers.length); layer++) {
+        this.#layers[layer].proxy.SetParameterName(names[layer]);
+      }
+    }
+    #InvalidateLayer(layer) {
+      this.#InvalidateLayers([layer]);
+    }
+    #InvalidateRange(count, topologyChanged = false) {
+      const layers = [];
+      for (let layer = 0; layer < count; layer++) layers.push(layer);
+      this.#InvalidateLayers(layers, topologyChanged);
+    }
+    #InvalidateLayers(layers, topologyChanged = false) {
+      const changed = [];
+      for (const layer of layers) {
+        if (!Number.isInteger(layer) || layer < 0 || layer >= this.#layers.length) continue;
+        this.#dirtyLayers.add(layer);
+        changed.push(layer);
+      }
+      if (!changed.length && !topologyChanged) return;
+      this.#topologyChanged ||= topologyChanged;
+      this.#failedRevision = 0;
+      this.#failedError = null;
+      this.#requestedRevision += 1;
+      this.#ScheduleUpdate();
+      this.EmitEvent("invalidated", this, Object.freeze(changed), this.#requestedRevision, Object.freeze({
+        topologyChanged: this.#topologyChanged
+      }));
+    }
+    #ScheduleUpdate() {
+      if (this.#updateScheduled) return;
+      this.#updateScheduled = true;
+      this.#updateScheduler?.(this);
+    }
+    #ResolveReadyWaiters(revision) {
+      const pending = [];
+      for (const waiter of this.#readyWaiters) {
+        if (waiter.revision <= revision) waiter.resolve(this);else pending.push(waiter);
+      }
+      this.#readyWaiters = pending;
+    }
+    #RejectReadyWaiters(revision, error) {
+      const pending = [];
+      for (const waiter of this.#readyWaiters) {
+        if (waiter.revision <= revision) waiter.reject(error);else pending.push(waiter);
+      }
+      this.#readyWaiters = pending;
+    }
+  }];
+  payload = "texture-array";
+  constructor() {
+    super(_CjsTextureArrayRes), _initClass();
+  }
+}();
+function DestroyAdapterValue(value) {
+  if (!value || typeof value !== "object" && typeof value !== "function") return;
+  const destroy = value.Destroy || value.Dispose || value.destroy || value.dispose;
+  if (typeof destroy === "function") destroy.call(value);
+}
+
+export { _CjsTextureArrayRes as CjsTextureArrayRes };
+//# sourceMappingURL=CjsTextureArrayRes.js.map

package/dist/texture/CjsTextureArrayRes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTextureArrayRes.js","sources":["../../../src/texture/CjsTextureArrayRes.js"],"sourcesContent":["import { type } from \"@carbonenginejs/core-types/schema\";\nimport { CjsResource } from \"../CjsResource.js\";\nimport { normalizeResourcePath } from \"../resourcePath.js\";\nimport { CjsTextureParameterProxy } from \"./CjsTextureParameterProxy.js\";\n\n/**\n * Mutable runtime aggregate for an ordered texture-array request.\n *\n * Private engine-bridge layer proxies only invalidate this parent. A resource\n * manager or engine scheduler consumes the coalesced update on a later frame\n * and prepares the corresponding immutable/cached texture-array payload.\n */\n@type.define({ className: \"CjsTextureArrayRes\", family: \"resource\" })\nexport class CjsTextureArrayRes extends CjsResource\n{\n  #layers = [];\n  #dirtyLayers = new Set();\n  #requestedRevision = 0;\n  #preparedRevision = 0;\n  #updateScheduled = false;\n  #topologyChanged = false;\n  #inFlightRequests = new Map();\n  #readyWaiters = [];\n  #failedRevision = 0;\n  #failedError = null;\n  #updateScheduler = null;\n  #updateHandler = null;\n\n  constructor(values = null)\n  {\n    const options = values && typeof values === \"object\" && !Array.isArray(values) ? values : {};\n    const resourceValues = { ...options };\n    delete resourceValues.layers;\n    delete resourceValues.paths;\n    delete resourceValues.layerCount;\n    delete resourceValues.layerNames;\n    delete resourceValues.updateScheduler;\n    delete resourceValues.updateHandler;\n    super(resourceValues);\n\n    if (options.updateScheduler) this.SetUpdateScheduler(options.updateScheduler);\n    if (options.updateHandler) this.SetUpdateHandler(options.updateHandler);\n\n    const paths = options.layers || options.paths;\n    if (paths !== undefined)\n    {\n      this.SetLayerResourcePaths(paths, options.layerNames);\n    }\n    else if (options.layerCount !== undefined)\n    {\n      this.SetLayerCount(options.layerCount, options.layerNames);\n    }\n  }\n\n  GetLayerCount()\n  {\n    return this.#layers.length;\n  }\n\n  SetLayerCount(value, names = null)\n  {\n    const count = Number(value);\n    if (!Number.isInteger(count) || count < 1)\n    {\n      throw new RangeError(\"CjsTextureArrayRes layer count must be a positive integer.\");\n    }\n    if (count === this.#layers.length)\n    {\n      this.#SetLayerNames(names);\n      return false;\n    }\n\n    const previousCount = this.#layers.length;\n    if (count < previousCount)\n    {\n      this.#layers.length = count;\n    }\n    else\n    {\n      for (let layer = previousCount; layer < count; layer++)\n      {\n        this.#layers.push(this.#CreateLayer(layer, names?.[layer]));\n      }\n    }\n    this.#SetLayerNames(names);\n    this.#InvalidateRange(count, true);\n    return true;\n  }\n\n  GetLayerParameter(layer)\n  {\n    return this.#GetLayer(layer).proxy;\n  }\n\n  GetLayerParameters(out = [])\n  {\n    for (const layer of this.#layers) out.push(layer.proxy);\n    return out;\n  }\n\n  GetLayerResourcePath(layer)\n  {\n    return this.#GetLayer(layer).path;\n  }\n\n  GetLayerResourcePaths(out = [])\n  {\n    for (const layer of this.#layers) out.push(layer.path);\n    return out;\n  }\n\n  SetLayerResourcePath(layer, value)\n  {\n    const record = this.#GetLayer(layer);\n    const path = normalizeResourcePath(value);\n    if (path === record.path) return false;\n    record.path = path;\n    record.resource = null;\n    this.#InvalidateLayer(layer);\n    return true;\n  }\n\n  SetLayerResourcePaths(values, names = null)\n  {\n    if (!Array.isArray(values) || values.length === 0)\n    {\n      throw new TypeError(\"CjsTextureArrayRes layers must be a non-empty array of resource paths.\");\n    }\n\n    const paths = values.map(value => normalizeResourcePath(\n      value && typeof value === \"object\"\n        ? value.resourcePath ?? value.path ?? value.GetPath?.() ?? \"\"\n        : value\n    ));\n    const topologyChanged = paths.length !== this.#layers.length;\n    let contentChanged = topologyChanged;\n    let namesChanged = false;\n    const changedLayers = new Set();\n    const next = [];\n    for (let layer = 0; layer < paths.length; layer++)\n    {\n      const current = this.#layers[layer];\n      const name = names?.[layer] ?? current?.proxy?.GetParameterName?.() ?? \"\";\n      if (!current)\n      {\n        next.push(this.#CreateLayer(layer, name, paths[layer]));\n      }\n      else\n      {\n        if (current.path !== paths[layer])\n        {\n          current.path = paths[layer];\n          current.resource = null;\n          contentChanged = true;\n          changedLayers.add(layer);\n        }\n        if (current.proxy.SetParameterName(name)) namesChanged = true;\n        next.push(current);\n      }\n    }\n    this.#layers = next;\n    if (topologyChanged)\n    {\n      this.#InvalidateRange(paths.length, true);\n    }\n    else if (contentChanged)\n    {\n      this.#InvalidateLayers(changedLayers);\n    }\n    return contentChanged || namesChanged;\n  }\n\n  GetLayerResource(layer)\n  {\n    return this.#GetLayer(layer).resource;\n  }\n\n  SetLayerResource(layer, resource)\n  {\n    const record = this.#GetLayer(layer);\n    const next = resource ?? null;\n    if (record.resource === next) return false;\n    record.resource = next;\n    this.#InvalidateLayer(layer);\n    return true;\n  }\n\n  /** Invalidate a layer whose resolved resource changed without changing identity. */\n  TouchLayer(layer)\n  {\n    this.#GetLayer(layer);\n    this.#InvalidateLayer(layer);\n    return this;\n  }\n\n  /** Invalidate every current layer, for example after an adapter generation loss. */\n  TouchAllLayers(options = {})\n  {\n    this.#InvalidateRange(this.#layers.length, !!options.topologyChanged);\n    return this;\n  }\n\n  GetRequestedRevision()\n  {\n    return this.#requestedRevision;\n  }\n\n  GetPreparedRevision()\n  {\n    return this.#preparedRevision;\n  }\n\n  NeedsUpdate()\n  {\n    return this.#updateScheduled || this.#dirtyLayers.size > 0 || this.#preparedRevision < this.#requestedRevision;\n  }\n\n  GetDirtyLayers()\n  {\n    return new Set(this.#dirtyLayers);\n  }\n\n  GetInFlightRevisions(out = [])\n  {\n    for (const revision of this.#inFlightRequests.keys()) out.push(revision);\n    return out.sort((a, b) => a - b);\n  }\n\n  IsRevisionInFlight(revision)\n  {\n    return this.#inFlightRequests.has(revision);\n  }\n\n  SetUpdateScheduler(schedule = null)\n  {\n    if (schedule !== null && typeof schedule !== \"function\")\n    {\n      throw new TypeError(\"CjsTextureArrayRes update scheduler must be a function or null.\");\n    }\n    this.#updateScheduler = schedule;\n    if (schedule && this.#updateScheduled) schedule(this);\n    return this;\n  }\n\n  SetUpdateHandler(handler = null)\n  {\n    if (handler !== null && typeof handler !== \"function\")\n    {\n      throw new TypeError(\"CjsTextureArrayRes update handler must be a function or null.\");\n    }\n    this.#updateHandler = handler;\n    return this;\n  }\n\n  /**\n   * Consume all proxy changes as one immutable request snapshot.\n   * A frame scheduler should call this at most once per parent per frame.\n   */\n  ConsumeUpdateRequest()\n  {\n    if (!this.#updateScheduled && this.#dirtyLayers.size === 0) return null;\n    const request = Object.freeze({\n      revision: this.#requestedRevision,\n      paths: Object.freeze(this.GetLayerResourcePaths()),\n      resources: Object.freeze(this.#layers.map(layer => layer.resource)),\n      dirtyLayers: Object.freeze([ ...this.#dirtyLayers ].sort((a, b) => a - b)),\n      topologyChanged: this.#topologyChanged\n    });\n    this.#dirtyLayers.clear();\n    this.#topologyChanged = false;\n    this.#updateScheduled = false;\n    this.#inFlightRequests.set(request.revision, request);\n    return request;\n  }\n\n  /** Requeue a consumed current request after cancellation, loss, or retryable failure. */\n  RetryUpdateRequest(revision = this.#requestedRevision)\n  {\n    const request = this.#inFlightRequests.get(revision);\n    if (!request) return false;\n    this.#inFlightRequests.delete(revision);\n    if (revision !== this.#requestedRevision) return false;\n    if (this.#failedRevision === revision)\n    {\n      this.#failedRevision = 0;\n      this.#failedError = null;\n    }\n    for (const layer of request.dirtyLayers)\n    {\n      if (layer < this.#layers.length) this.#dirtyLayers.add(layer);\n    }\n    this.#topologyChanged ||= request.topologyChanged;\n    this.#ScheduleUpdate();\n    this.EmitEvent(\"revisionretry\", this, revision);\n    return true;\n  }\n\n  /** Complete a consumed request as failed, optionally making it retryable. */\n  FailUpdateRequest(revision, error, options = {})\n  {\n    if (options.retry) return this.RetryUpdateRequest(revision);\n    if (!this.#inFlightRequests.has(revision)) return false;\n    this.#inFlightRequests.delete(revision);\n    if (revision !== this.#requestedRevision) return false;\n    const failure = error instanceof Error ? error : new Error(String(error ?? \"Texture array preparation failed.\"));\n    this.#failedRevision = revision;\n    this.#failedError = failure;\n    if (this.#preparedRevision === 0) this.SetError(failure);\n    this.EmitEvent(\"revisionfailed\", this, revision, failure);\n    this.#RejectReadyWaiters(revision, failure);\n    return true;\n  }\n\n  /** Run the registered update handler for the current coalesced frame request. */\n  Update(context = {})\n  {\n    const request = this.ConsumeUpdateRequest();\n    if (!request) return null;\n    this.EmitEvent(\"update\", this, request, context);\n    return this.#updateHandler\n      ? this.#updateHandler(this, request, context)\n      : request;\n  }\n\n  /**\n   * Atomically publish an opaque adapter allocation with its prepared revision.\n   * The caller owns disposal of a successfully displaced allocation.\n   */\n  CommitPreparedAdapterRevision(revision, adapterKey, candidate, options = {})\n  {\n    if (!adapterKey) throw new TypeError(\"CjsTextureArrayRes adapter publication requires a key.\");\n    if (candidate === null || candidate === undefined)\n    {\n      throw new TypeError(\"CjsTextureArrayRes adapter publication requires a candidate allocation.\");\n    }\n    const inFlight = this.#inFlightRequests.has(revision);\n    if (!inFlight || revision !== this.#requestedRevision)\n    {\n      if (inFlight) this.#inFlightRequests.delete(revision);\n      if (options.destroyRejected !== false) DestroyAdapterValue(candidate);\n      return Object.freeze({ published: false, revision, displaced: null });\n    }\n\n    const displaced = this.GetAdapterResource(adapterKey);\n    this.SetAdapterResource(adapterKey, candidate);\n    this.#preparedRevision = revision;\n    this.#failedRevision = 0;\n    this.#failedError = null;\n    this.#inFlightRequests.delete(revision);\n    for (const pendingRevision of this.#inFlightRequests.keys())\n    {\n      if (pendingRevision < revision) this.#inFlightRequests.delete(pendingRevision);\n    }\n    this.MarkPrepared();\n    this.EmitEvent(\"revisionprepared\", this, revision, adapterKey, candidate);\n    this.#ResolveReadyWaiters(revision);\n    return Object.freeze({\n      published: true,\n      revision,\n      displaced: displaced === candidate ? null : displaced\n    });\n  }\n\n  /** Destroy an unusable adapter allocation and request a complete rebuild. */\n  HandleAdapterLoss(adapterKey, options = {})\n  {\n    if (!adapterKey) throw new TypeError(\"CjsTextureArrayRes adapter loss requires a key.\");\n    const lost = this.GetAdapterResource(adapterKey);\n    if (this.HasAdapterResource(adapterKey)) this.DestroyAdapterResource(adapterKey, options);\n    this.#preparedRevision = 0;\n    if (this.#layers.length) this.#InvalidateRange(this.#layers.length, true);\n    if (this.state === CjsResource.State.PREPARED) this.MarkPreparing();\n    this.EmitEvent(\"adapterlost\", this, adapterKey, lost);\n    return lost;\n  }\n\n  /** Resolve when the generation requested at call time has been prepared. */\n  Ready()\n  {\n    if (this.#requestedRevision === 0)\n    {\n      const error = new Error(\"Texture array resource has no configured layers.\");\n      error.code = \"CJS_TEXTURE_ARRAY_UNCONFIGURED\";\n      return Promise.reject(error);\n    }\n    const revision = this.#requestedRevision;\n    if (this.#preparedRevision >= revision && this.IsPrepared()) return Promise.resolve(this);\n    if (this.#failedRevision === revision) return Promise.reject(this.#failedError);\n    return new Promise((resolve, reject) =>\n    {\n      this.#readyWaiters.push({ revision, resolve, reject });\n    });\n  }\n\n  #CreateLayer(layer, name = \"\", path = \"\")\n  {\n    return {\n      path: normalizeResourcePath(path),\n      resource: null,\n      proxy: new CjsTextureParameterProxy(this, layer, { name })\n    };\n  }\n\n  #GetLayer(layer)\n  {\n    if (!Number.isInteger(layer) || layer < 0 || layer >= this.#layers.length)\n    {\n      throw new RangeError(`CjsTextureArrayRes layer ${layer} is out of range.`);\n    }\n    return this.#layers[layer];\n  }\n\n  #SetLayerNames(names)\n  {\n    if (!names) return;\n    for (let layer = 0; layer < Math.min(names.length, this.#layers.length); layer++)\n    {\n      this.#layers[layer].proxy.SetParameterName(names[layer]);\n    }\n  }\n\n  #InvalidateLayer(layer)\n  {\n    this.#InvalidateLayers([ layer ]);\n  }\n\n  #InvalidateRange(count, topologyChanged = false)\n  {\n    const layers = [];\n    for (let layer = 0; layer < count; layer++) layers.push(layer);\n    this.#InvalidateLayers(layers, topologyChanged);\n  }\n\n  #InvalidateLayers(layers, topologyChanged = false)\n  {\n    const changed = [];\n    for (const layer of layers)\n    {\n      if (!Number.isInteger(layer) || layer < 0 || layer >= this.#layers.length) continue;\n      this.#dirtyLayers.add(layer);\n      changed.push(layer);\n    }\n    if (!changed.length && !topologyChanged) return;\n    this.#topologyChanged ||= topologyChanged;\n    this.#failedRevision = 0;\n    this.#failedError = null;\n    this.#requestedRevision += 1;\n    this.#ScheduleUpdate();\n    this.EmitEvent(\"invalidated\", this, Object.freeze(changed), this.#requestedRevision, Object.freeze({\n      topologyChanged: this.#topologyChanged\n    }));\n  }\n\n  #ScheduleUpdate()\n  {\n    if (this.#updateScheduled) return;\n    this.#updateScheduled = true;\n    this.#updateScheduler?.(this);\n  }\n\n  #ResolveReadyWaiters(revision)\n  {\n    const pending = [];\n    for (const waiter of this.#readyWaiters)\n    {\n      if (waiter.revision <= revision) waiter.resolve(this);\n      else pending.push(waiter);\n    }\n    this.#readyWaiters = pending;\n  }\n\n  #RejectReadyWaiters(revision, error)\n  {\n    const pending = [];\n    for (const waiter of this.#readyWaiters)\n    {\n      if (waiter.revision <= revision) waiter.reject(error);\n      else pending.push(waiter);\n    }\n    this.#readyWaiters = pending;\n  }\n\n  static payload = \"texture-array\";\n}\n\nfunction DestroyAdapterValue(value)\n{\n  if (!value || (typeof value !== \"object\" && typeof value !== \"function\")) return;\n  const destroy = value.Destroy || value.Dispose || value.destroy || value.dispose;\n  if (typeof destroy === \"function\") destroy.call(value);\n}\n"],"names":["_CjsTextureArrayRes","_identity","CjsTextureArrayRes","CjsResource","_initClass","_applyDecs","type","define","className","family","c","Set","Map","constructor","values","options","Array","isArray","resourceValues","layers","paths","layerCount","layerNames","updateScheduler","updateHandler","SetUpdateScheduler","SetUpdateHandler","undefined","SetLayerResourcePaths","SetLayerCount","GetLayerCount","length","value","names","count","Number","isInteger","RangeError","previousCount","layer","push","GetLayerParameter","proxy","GetLayerParameters","out","GetLayerResourcePath","path","GetLayerResourcePaths","SetLayerResourcePath","record","normalizeResourcePath","resource","TypeError","map","resourcePath","GetPath","topologyChanged","contentChanged","namesChanged","changedLayers","next","current","name","GetParameterName","add","SetParameterName","GetLayerResource","SetLayerResource","TouchLayer","TouchAllLayers","GetRequestedRevision","GetPreparedRevision","NeedsUpdate","size","GetDirtyLayers","GetInFlightRevisions","revision","keys","sort","a","b","IsRevisionInFlight","has","schedule","handler","ConsumeUpdateRequest","request","Object","freeze","resources","dirtyLayers","clear","set","RetryUpdateRequest","get","delete","EmitEvent","FailUpdateRequest","error","retry","failure","Error","String","SetError","Update","context","CommitPreparedAdapterRevision","adapterKey","candidate","inFlight","destroyRejected","DestroyAdapterValue","published","displaced","GetAdapterResource","SetAdapterResource","pendingRevision","MarkPrepared","HandleAdapterLoss","lost","HasAdapterResource","DestroyAdapterResource","state","State","PREPARED","MarkPreparing","Ready","code","Promise","reject","IsPrepared","resolve","#CreateLayer","CjsTextureParameterProxy","#GetLayer","#SetLayerNames","Math","min","#InvalidateLayer","#InvalidateRange","#InvalidateLayers","changed","#ScheduleUpdate","#ResolveReadyWaiters","pending","waiter","#RejectReadyWaiters","payload","destroy","Destroy","Dispose","dispose","call"],"mappings":"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"}

package/dist/texture/CjsTextureParameterProxy.js

@@ -0,0 +1,133 @@
+import { CjsEventEmitter } from '@carbonenginejs/core-types/model';
+
+/**
+ * Runtime-only internal texture parameter facade for one array layer.
+ *
+ * The proxy mirrors the public texture-parameter path API while delegating
+ * storage, invalidation, readiness, and adapter ownership to its parent array.
+ * Engines bridge public parameters into it; it does not replace persisted
+ * parameter entries or their individual source resources. It deliberately
+ * carries no shader metadata or backend objects.
+ */
+class CjsTextureParameterProxy extends CjsEventEmitter {
+  #parent;
+  #layer;
+  #name;
+  constructor(parent, layer, options = {}) {
+    super();
+    if (!parent || typeof parent.SetLayerResourcePath !== "function") {
+      throw new TypeError("CjsTextureParameterProxy requires a CjsTextureArrayRes-compatible parent.");
+    }
+    if (!Number.isInteger(layer) || layer < 0) {
+      throw new RangeError("CjsTextureParameterProxy layer must be a non-negative integer.");
+    }
+    this.#parent = parent;
+    this.#layer = layer;
+    this.#name = options.name === undefined ? "" : String(options.name);
+  }
+  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;
+  }
+  set resourcePath(value) {
+    this.SetResourcePath(value);
+  }
+  get name() {
+    return this.#name;
+  }
+  set name(value) {
+    this.SetParameterName(value);
+  }
+  GetParent() {
+    return this.#parent;
+  }
+  GetLayerIndex() {
+    return this.#layer;
+  }
+  GetParameterName() {
+    return this.#name;
+  }
+  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;
+  }
+  GetResourcePath() {
+    return this.#parent.GetLayerResourcePath(this.#layer);
+  }
+  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;
+  }
+  GetValue() {
+    return this.GetResourcePath();
+  }
+  SetValue(value) {
+    if (value === undefined) return false;
+    return this.SetResourcePath(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);
+  }
+  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;
+  }
+  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;
+  }
+  GetResources(out = []) {
+    if (!out.includes(this.#parent)) out.push(this.#parent);
+    return out;
+  }
+  IsPrepared() {
+    return this.#parent.IsPrepared();
+  }
+  IsGood() {
+    return this.#parent.IsGood();
+  }
+  Ready(options = {}) {
+    return this.#parent.Ready(options);
+  }
+}
+
+export { CjsTextureParameterProxy };
+//# sourceMappingURL=CjsTextureParameterProxy.js.map

package/dist/texture/CjsTextureParameterProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsTextureParameterProxy.js","sources":["../../../src/texture/CjsTextureParameterProxy.js"],"sourcesContent":["import { CjsEventEmitter } from \"@carbonenginejs/core-types/model\";\n\n/**\n * Runtime-only internal texture parameter facade for one array layer.\n *\n * The proxy mirrors the public texture-parameter path API while delegating\n * storage, invalidation, readiness, and adapter ownership to its parent array.\n * Engines bridge public parameters into it; it does not replace persisted\n * parameter entries or their individual source resources. It deliberately\n * carries no shader metadata or backend objects.\n */\nexport class CjsTextureParameterProxy extends CjsEventEmitter\n{\n  #parent;\n  #layer;\n  #name;\n\n  constructor(parent, layer, options = {})\n  {\n    super();\n    if (!parent || typeof parent.SetLayerResourcePath !== \"function\")\n    {\n      throw new TypeError(\"CjsTextureParameterProxy requires a CjsTextureArrayRes-compatible parent.\");\n    }\n    if (!Number.isInteger(layer) || layer < 0)\n    {\n      throw new RangeError(\"CjsTextureParameterProxy layer must be a non-negative integer.\");\n    }\n\n    this.#parent = parent;\n    this.#layer = layer;\n    this.#name = options.name === undefined ? \"\" : String(options.name);\n  }\n\n  get resourcePath()\n  {\n    return this.GetResourcePath();\n  }\n\n  /** The aggregate texture resource used by the shader. */\n  get textureRes()\n  {\n    return this.#parent;\n  }\n\n  /** Compatibility alias for textureRes. */\n  get res()\n  {\n    return this.#parent;\n  }\n\n  /** Compatibility alias used by Carbon-shaped texture parameters. */\n  get resource()\n  {\n    return this.#parent;\n  }\n\n  set resourcePath(value)\n  {\n    this.SetResourcePath(value);\n  }\n\n  get name()\n  {\n    return this.#name;\n  }\n\n  set name(value)\n  {\n    this.SetParameterName(value);\n  }\n\n  GetParent()\n  {\n    return this.#parent;\n  }\n\n  GetLayerIndex()\n  {\n    return this.#layer;\n  }\n\n  GetParameterName()\n  {\n    return this.#name;\n  }\n\n  SetParameterName(value)\n  {\n    const next = value === null || value === undefined ? \"\" : String(value);\n    if (next === this.#name) return false;\n    const previous = this.#name;\n    this.#name = next;\n    this.EmitEvent(\"changed\", this, \"name\", next, previous);\n    return true;\n  }\n\n  GetResourcePath()\n  {\n    return this.#parent.GetLayerResourcePath(this.#layer);\n  }\n\n  SetResourcePath(value)\n  {\n    const previous = this.GetResourcePath();\n    if (!this.#parent.SetLayerResourcePath(this.#layer, value)) return false;\n    this.EmitEvent(\"changed\", this, \"resourcepath\", this.GetResourcePath(), previous);\n    return true;\n  }\n\n  GetValue()\n  {\n    return this.GetResourcePath();\n  }\n\n  SetValue(value)\n  {\n    if (value === undefined) return false;\n    return this.SetResourcePath(value);\n  }\n\n  EqualsValue(value)\n  {\n    return String(value ?? \"\").trim().replace(/\\\\/gu, \"/\").replace(/\\/+/gu, \"/\").toLowerCase() === this.GetResourcePath();\n  }\n\n  /** Return the aggregate texture resource used by the shader binding. */\n  GetResource()\n  {\n    return this.#parent;\n  }\n\n  /** Return the optional resolved source resource for this layer. */\n  GetSourceResource()\n  {\n    return this.#parent.GetLayerResource(this.#layer);\n  }\n\n  SetSourceResource(resource)\n  {\n    const previous = this.GetSourceResource();\n    if (!this.#parent.SetLayerResource(this.#layer, resource)) return false;\n    this.EmitEvent(\"changed\", this, \"sourceresource\", this.GetSourceResource(), previous);\n    return true;\n  }\n\n  SetResource(resource)\n  {\n    return this.SetSourceResource(resource);\n  }\n\n  /** Invalidate this layer after an in-place source content revision. */\n  Touch()\n  {\n    this.#parent.TouchLayer(this.#layer);\n    this.EmitEvent(\"changed\", this, \"sourcerevision\", this.GetSourceResource());\n    return this;\n  }\n\n  GetResources(out = [])\n  {\n    if (!out.includes(this.#parent)) out.push(this.#parent);\n    return out;\n  }\n\n  IsPrepared()\n  {\n    return this.#parent.IsPrepared();\n  }\n\n  IsGood()\n  {\n    return this.#parent.IsGood();\n  }\n\n  Ready(options = {})\n  {\n    return this.#parent.Ready(options);\n  }\n}\n"],"names":["CjsTextureParameterProxy","CjsEventEmitter","constructor","parent","layer","options","SetLayerResourcePath","TypeError","Number","isInteger","RangeError","name","undefined","String","resourcePath","GetResourcePath","textureRes","res","resource","value","SetResourcePath","SetParameterName","GetParent","GetLayerIndex","GetParameterName","next","previous","EmitEvent","GetLayerResourcePath","GetValue","SetValue","EqualsValue","trim","replace","toLowerCase","GetResource","GetSourceResource","GetLayerResource","SetSourceResource","SetLayerResource","SetResource","Touch","TouchLayer","GetResources","out","includes","push","IsPrepared","IsGood","Ready"],"mappings":"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"}

package/format-notices/black/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CarbonEngineJS contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.