@carbonenginejs/runtime 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/global/compose/values.js

@@ -43,29 +43,98 @@ import { ensureRuntimeState, getRuntimeState } from './runtimeState.js';
 // siblings are fine - they import nothing themselves.
 
 
-/** Carbon's own guard against a settle that will not converge. */
+/** Bound for the JS values transport's cooperative settle. */
 const MAX_UPDATE_PASSES = 32;
 
+/** Records a member before a deferred or reentrant values update returns. */
+function queueModifiedMember(target, propertyName) {
+  const state = ensureRuntimeState(target);
+  (state.pendingModified ??= new Set()).add(propertyName);
+}
+
+/**
+ * JS values batching over Carbon's single-member INotify hook. The queue is
+ * transport state, not class invalidation state. Callers apply their own
+ * NOTIFY gate before recording a member. A null member preserves the existing
+ * explicit, unnamed UpdateValues contract pending its separate policy review.
+ */
+function settleModifiedMembers(target) {
+  const state = ensureRuntimeState(target);
+  if (state.updating) return true;
+  state.updating = true;
+  try {
+    for (let pass = 0;; pass++) {
+      if (pass >= MAX_UPDATE_PASSES) {
+        throw new Error(`${target.constructor.name} exceeded ${MAX_UPDATE_PASSES} settle passes.`);
+      }
+      const pending = state.pendingModified ?? new Set();
+      state.pendingModified = new Set();
+      state.dirty = false;
+      const members = Array.from(pending);
+      for (let index = 0; index < members.length; index++) {
+        let accepted;
+        try {
+          accepted = typeof target.OnModified !== "function" || target.OnModified(members[index]) !== false;
+        } catch (error) {
+          restore(index);
+          throw error;
+        }
+        if (!accepted) {
+          restore(index);
+          state.dirty = true;
+          return false;
+        }
+      }
+      if (!state.pendingModified.size) break;
+      function restore(index) {
+        const remaining = new Set();
+        for (; index < members.length; index++) remaining.add(members[index]);
+        for (const member of state.pendingModified) remaining.add(member);
+        state.pendingModified = remaining;
+      }
+    }
+    state.dirty = false;
+    return true;
+  } catch (error) {
+    state.dirty = true;
+    throw error;
+  } finally {
+    state.updating = false;
+  }
+}
+
 /**
  * Whether a declared field accepts an incoming value.
  *
- * Carbon's deserializer semantics, and deliberately identical to the model
- * path's rule: PERSIST or WRITE is writable, and the only refusal is read-only
- * WITHOUT persist - runtime-derived state the wire should never carry and
- * Initialize recomputes. There is no caller-side capability to relax this,
- * because a field Carbon persists is already writable here.
+ * The JS values import accepts WRITE, PERSIST and RPERSIST independently.
+ * RPERSIST follows BlueTypes' load-only contract, including where the donor's
+ * DictReader currently checks only PERSIST. This is a serialization service,
+ * not BluePyWrap property access; unflagged declared fields retain JS support.
  *
  * @param {object} field
  * @returns {Boolean}
  */
 function isWritableField(field) {
-  const io = field?.io;
-  if (!io) return true;
-  if (io.write || io.persist || io.persistOnly) return true;
-  if (io.read && !io.write) return false;
+  const edit = field?.edit;
+  if (!edit) return true;
+  if (edit.write || edit.persist || edit.rpersist || edit.persistOnly) return true;
+  if (edit.read && !edit.write) return false;
   return true;
 }
 
+/**
+ * Selects persisted output by PERSIST, not RPERSIST.
+ * The unrestricted JS values view retains all declared fields.
+ * @param {object} field Declared field metadata.
+ * @param {object} options Values export options.
+ * @returns {boolean} Whether this field belongs in the exported values.
+ */
+function isExportableField(field, options = {}) {
+  const edit = field?.edit;
+  const persist = edit?.persist || edit?.persistOnly;
+  return !options.persistOnly || !!persist;
+}
+
 /**
  * Builds the state-free transport over a set of schema services.
  *
@@ -99,7 +168,7 @@ function createValuesTransport(services) {
    */
   function getValues(target, out = {}, options = {}) {
     for (const field of GetFields(target.constructor)) {
-      if (options.persistOnly && !(field.io?.persist || field.io?.persistOnly)) continue;
+      if (!isExportableField(field, options)) continue;
       out[field.name] = Export(target[field.name], field, options);
     }
     return out;
@@ -117,6 +186,7 @@ function createValuesTransport(services) {
    */
   function setValues(target, values = {}, options = {}) {
     const changed = new Set();
+    let notifyRequested = false;
     for (const field of GetFields(target.constructor)) {
       if (!isWritableField(field)) continue;
       if (!Object.hasOwn(values, field.name)) continue;
@@ -127,34 +197,38 @@ function createValuesTransport(services) {
       // holding a reference to it keeps seeing live values.
       const coerced = CoerceInto(current, incoming, field);
       if (coerced !== null) {
-        if (coerced || field.io?.always === true) changed.add(field.name);
+        recordWrite(field, coerced);
         continue;
       }
       const next = Import(incoming, field, options);
-      if (field.io?.always === true || !IsEquivalent(current, next)) {
-        target[field.name] = next;
-        changed.add(field.name);
-      }
+      const didChange = !IsEquivalent(current, next);
+      target[field.name] = next;
+      recordWrite(field, didChange);
     }
 
-    // Nothing moved, so nothing is dirty and no state is created. This is
-    // what makes the slot free for an object that is only ever read.
-    if (changed.size && options.markDirty !== false) {
-      ensureRuntimeState(target).dirty = true;
+    // Settle actual changes or explicitly requested equal-write notifications.
+    if ((changed.size || notifyRequested) && options.markDirty !== false) {
       if (options.skipUpdate !== true) updateValues(target, options, changed);
     }
+
+    // Preserve each successful mutation if a later import or setter throws.
+    function recordWrite(field, didChange) {
+      if (didChange) changed.add(field.name);
+      if (options.markDirty !== false) {
+        if (didChange) ensureRuntimeState(target).dirty = true;
+        // BluePyWrap writes first, then tests NOTIFY without equality.
+        if (options.notify !== false && field.edit?.notify) {
+          queueModifiedMember(target, field.name);
+          ensureRuntimeState(target).dirty = true;
+          notifyRequested = true;
+        }
+      }
+    }
     return options.returnBoolean === true ? changed.size > 0 : changed;
   }
 
   /**
-   * Carbon's INotify settle: run OnModified until nothing re-dirties.
-   *
-   * The changed field names ride through on the options bag. That is
-   * ADDITIVE and verified safe: all 34 overrides carrying a positional
-   * parameter receive the options OBJECT today, so gates comparing it to a
-   * field name are false now and stay false. Passing a name POSITIONALLY
-   * would instead flip the three `!propertyName || ...` arms from never
-   * firing to always firing, which is why it is not done that way.
+   * Settles queued single-member notifications and emits once after success.
    *
    * @param {object} target
    * @param {object} options
@@ -163,6 +237,14 @@ function createValuesTransport(services) {
    */
   function updateValues(target, options, changedFields) {
     const state = ensureRuntimeState(target);
+    const properties = options.property ?? options.properties;
+    if (properties != null) {
+      for (const name of typeof properties === "string" ? [properties] : properties) {
+        queueModifiedMember(target, name);
+      }
+    } else if (changedFields == null && (state.updating || !state.pendingModified?.size)) {
+      queueModifiedMember(target, null);
+    }
     if (state.updating) return true;
 
     // INotify is OPTIONAL, in Carbon as here: an object that does not
@@ -171,33 +253,12 @@ function createValuesTransport(services) {
     // so have no OnModified - those settle trivially rather than throwing.
     const hook = target.OnModified;
     if (typeof hook !== "function") {
+      state.pendingModified?.clear();
       state.dirty = false;
       return true;
     }
     const source = options.source ?? target;
-    state.updating = true;
-    try {
-      for (let pass = 0;; pass++) {
-        if (pass >= MAX_UPDATE_PASSES) {
-          throw new Error(`${target.constructor?.name ?? "value"} exceeded ${MAX_UPDATE_PASSES} settle passes.`);
-        }
-        state.dirty = false;
-        if (hook.call(target, {
-          ...options,
-          source,
-          changedFields
-        }) === false) {
-          state.dirty = true;
-          return false;
-        }
-        if (!state.dirty) break;
-      }
-    } catch (error) {
-      state.dirty = true;
-      throw error;
-    } finally {
-      state.updating = false;
-    }
+    if (!settleModifiedMembers(target)) return false;
 
     // `HasListener` lives on the state slot itself, so it exists whatever
     // decorators the class took, and answers false when no emitter was
@@ -255,7 +316,9 @@ function composeValuesDecorator(transport) {
       return getRuntimeState(this)?.dirty === true;
     },
     MarkDirty() {
-      ensureRuntimeState(this).dirty = true;
+      const state = ensureRuntimeState(this);
+      state.dirty = true;
+      if (state.updating) queueModifiedMember(this, null);
       return this;
     },
     ClearDirty() {
@@ -282,5 +345,5 @@ function composeValuesDecorator(transport) {
   };
 }
 
-export { composeValuesDecorator, createValuesTransport, isWritableField };
+export { composeValuesDecorator, createValuesTransport, isExportableField, isWritableField, queueModifiedMember, settleModifiedMembers };
 //# sourceMappingURL=values.js.map

package/dist/global/compose/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","sources":["../../../../src/global/compose/values.js"],"sourcesContent":["// The values transport as COMPOSITION - the @compose.values decorator.\r\n//\r\n// Carbon keeps transport in SERVICES over its per-class VarEntry table:\r\n// BlackReader, the Copier and Python's getattr/setattr all drive Be::ClassInfo\r\n// from OUTSIDE the object, and no Blue base carries a GetValues. Ours put the\r\n// same work on a base class, which is what made `extends CjsModel` mandatory\r\n// for 886 classes and occupied the one `extends` slot JS has.\r\n//\r\n// `CjsSchema.getValues`/`setValues` are already the declared home - they exist\r\n// as statics forwarding to a registered service. The service's third arm, for\r\n// a decorated class carrying NEITHER method, threw by name:\r\n//\r\n//     \"CjsSchema.setValues on a plain decorated class awaits the facade\r\n//      migration's state-free transport.\"\r\n//\r\n// This module is that transport, and the decorator that installs it as\r\n// GetValues/SetValues on a class that wants the methods rather than the\r\n// statics. Nothing here touches CjsModel, so a class taking @compose.values\r\n// pays for none of the base.\r\n//\r\n// STATE IS LAZY, NOT ABSENT, and the distinction is the whole contract.\r\n// `setValues` does coercion, then the changed set, then dirty, then the settle\r\n// WITH the changed field names. The settle is one of the three benefits the\r\n// CjsModel audit found real - 95 classes override OnModified, and\r\n// TriValueBinding drives it per frame - so a transport that skipped it would\r\n// silently stop running every one of those bodies for any class that moved off\r\n// the base. The error message this module replaced said \"state-free\r\n// transport\"; that phrasing was a previous session's and contradicts the\r\n// decision page, which rules edit state LAZY: materialising on first write,\r\n// zero footprint until then.\r\n//\r\n// The mechanism is `ensureRuntimeState`, which creates the non-enumerable\r\n// `__state` slot only when it is not already there - the same slot\r\n// @compose.notify puts its listener map in, and the same one CjsModel fills\r\n// with a CjsModelState. An unedited object carries nothing.\r\n//\r\n// This module imports nothing from the SCHEMA layer, for the reason\r\n// compose/notify.js and compose/interface.js import nothing: CjsSchema installs\r\n// these onto its own namespace, so a schema import here is a cycle that fails\r\n// at load. Everything schema-shaped arrives through `services`. compose/\r\n// siblings are fine - they import nothing themselves.\r\n\r\nimport { ensureRuntimeState, getRuntimeState } from \"./runtimeState.js\";\r\n\r\n\r\n/** Carbon's own guard against a settle that will not converge. */\r\nconst MAX_UPDATE_PASSES = 32;\r\n\r\n/**\r\n * Whether a declared field accepts an incoming value.\r\n *\r\n * Carbon's deserializer semantics, and deliberately identical to the model\r\n * path's rule: PERSIST or WRITE is writable, and the only refusal is read-only\r\n * WITHOUT persist - runtime-derived state the wire should never carry and\r\n * Initialize recomputes. There is no caller-side capability to relax this,\r\n * because a field Carbon persists is already writable here.\r\n *\r\n * @param {object} field\r\n * @returns {Boolean}\r\n */\r\nexport function isWritableField(field)\r\n{\r\n    const io = field?.io;\r\n    if (!io) return true;\r\n    if (io.write || io.persist || io.persistOnly) return true;\r\n    if (io.read && !io.write) return false;\r\n    return true;\r\n}\r\n\r\n\r\n/**\r\n * Builds the state-free transport over a set of schema services.\r\n *\r\n * @param {object} services\r\n * @param {Function} services.GetFields Effective field records for a class.\r\n * @param {Function} services.Export Exports one declared value.\r\n * @param {Function} services.Import Coerces one incoming value.\r\n * @param {Function} services.CoerceInto In-place coercion; null when it does\r\n *     not apply, so the caller falls back to an allocating import.\r\n * @param {Function} services.IsEquivalent Compares two declared values.\r\n * @returns {{getValues: Function, setValues: Function}}\r\n */\r\nexport function createValuesTransport(services)\r\n{\r\n    const { GetFields, Export, Import, CoerceInto, IsEquivalent } = services;\r\n\r\n    /**\r\n     * Exports a decorated class's declared fields into a plain bag.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} [out] A bag the caller owns, for composing several\r\n     *     exports into one object - the reason the static carries `out` while\r\n     *     the instance method does not.\r\n     * @param {object} [options]\r\n     * @returns {object}\r\n     */\r\n    function getValues(target, out = {}, options = {})\r\n    {\r\n        for (const field of GetFields(target.constructor))\r\n        {\r\n            if (options.persistOnly && !(field.io?.persist || field.io?.persistOnly)) continue;\r\n            out[field.name] = Export(target[field.name], field, options);\r\n        }\r\n        return out;\r\n    }\r\n\r\n    /**\r\n     * Applies a plain bag to a decorated class's declared fields.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} [values]\r\n     * @param {object} [options]\r\n     * @returns {Set<String>|Boolean} The changed field names, or a boolean when\r\n     *     `options.returnBoolean` is set - the shape Carbon's Change and Set\r\n     *     methods return.\r\n     */\r\n    function setValues(target, values = {}, options = {})\r\n    {\r\n        const changed = new Set();\r\n\r\n        for (const field of GetFields(target.constructor))\r\n        {\r\n            if (!isWritableField(field)) continue;\r\n            if (!Object.hasOwn(values, field.name)) continue;\r\n\r\n            const incoming = values[field.name];\r\n            const current = target[field.name];\r\n\r\n            // In place first, so a typed array keeps its identity and anything\r\n            // holding a reference to it keeps seeing live values.\r\n            const coerced = CoerceInto(current, incoming, field);\r\n            if (coerced !== null)\r\n            {\r\n                if (coerced || field.io?.always === true) changed.add(field.name);\r\n                continue;\r\n            }\r\n\r\n            const next = Import(incoming, field, options);\r\n            if (field.io?.always === true || !IsEquivalent(current, next))\r\n            {\r\n                target[field.name] = next;\r\n                changed.add(field.name);\r\n            }\r\n        }\r\n\r\n        // Nothing moved, so nothing is dirty and no state is created. This is\r\n        // what makes the slot free for an object that is only ever read.\r\n        if (changed.size && options.markDirty !== false)\r\n        {\r\n            ensureRuntimeState(target).dirty = true;\r\n\r\n            if (options.skipUpdate !== true) updateValues(target, options, changed);\r\n        }\r\n\r\n        return options.returnBoolean === true ? changed.size > 0 : changed;\r\n    }\r\n\r\n    /**\r\n     * Carbon's INotify settle: run OnModified until nothing re-dirties.\r\n     *\r\n     * The changed field names ride through on the options bag. That is\r\n     * ADDITIVE and verified safe: all 34 overrides carrying a positional\r\n     * parameter receive the options OBJECT today, so gates comparing it to a\r\n     * field name are false now and stay false. Passing a name POSITIONALLY\r\n     * would instead flip the three `!propertyName || ...` arms from never\r\n     * firing to always firing, which is why it is not done that way.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} options\r\n     * @param {Set<String>} changedFields\r\n     * @returns {Boolean} False when a hook refused, leaving the target dirty.\r\n     */\r\n    function updateValues(target, options, changedFields)\r\n    {\r\n        const state = ensureRuntimeState(target);\r\n        if (state.updating) return true;\r\n\r\n        // INotify is OPTIONAL, in Carbon as here: an object that does not\r\n        // implement the hook is simply never notified. The statics serve any\r\n        // decorated class, including ones that never took @compose.values and\r\n        // so have no OnModified - those settle trivially rather than throwing.\r\n        const hook = target.OnModified;\r\n        if (typeof hook !== \"function\")\r\n        {\r\n            state.dirty = false;\r\n            return true;\r\n        }\r\n\r\n        const source = options.source ?? target;\r\n        state.updating = true;\r\n\r\n        try\r\n        {\r\n            for (let pass = 0; ; pass++)\r\n            {\r\n                if (pass >= MAX_UPDATE_PASSES)\r\n                {\r\n                    throw new Error(\r\n                        `${target.constructor?.name ?? \"value\"} exceeded ${MAX_UPDATE_PASSES} settle passes.`);\r\n                }\r\n\r\n                state.dirty = false;\r\n\r\n                if (hook.call(target, { ...options, source, changedFields }) === false)\r\n                {\r\n                    state.dirty = true;\r\n                    return false;\r\n                }\r\n\r\n                if (!state.dirty) break;\r\n            }\r\n        }\r\n        catch (error)\r\n        {\r\n            state.dirty = true;\r\n            throw error;\r\n        }\r\n        finally\r\n        {\r\n            state.updating = false;\r\n        }\r\n\r\n        // `HasListener` lives on the state slot itself, so it exists whatever\r\n        // decorators the class took, and answers false when no emitter was\r\n        // ever attached - which is also what keeps EmitEvent from being called\r\n        // on a class that does not have it.\r\n        //\r\n        // The emitter no-ops without listeners anyway, so the guard is really\r\n        // about the PAYLOAD: it stops one being built per settle for nobody,\r\n        // the waste the audit measured on the per-frame binding path.\r\n        if (options.skipEvents !== true && !state.suppressEvents && state.HasListener())\r\n        {\r\n            target.EmitEvent(\"modified\", target, { source, changedFields });\r\n        }\r\n\r\n        return true;\r\n    }\r\n\r\n    return { getValues, setValues, updateValues };\r\n}\r\n\r\n\r\n/**\r\n * The `@compose.values` class decorator.\r\n *\r\n * Installs `GetValues(options)` and `SetValues(values, options)` install-if-\r\n * absent, so a class that hand-rolls either keeps its own. The instance shapes\r\n * match the model's exactly: `GetValues` takes options only, because a fresh\r\n * bag is the only sensible target for `this`, while the static keeps `out`.\r\n *\r\n * @param {object} transport The transport from createValuesTransport.\r\n * @returns {Function} A stage-3 class decorator.\r\n */\r\nexport function composeValuesDecorator(transport)\r\n{\r\n    const METHODS = {\r\n        GetValues(options = {}) { return transport.getValues(this, {}, options); },\r\n        SetValues(values = {}, options = {}) { return transport.setValues(this, values, options); },\r\n        UpdateValues(options = {}) { return transport.updateValues(this, options, options.changedFields ?? null); },\r\n\r\n        /**\r\n         * Carbon's INotify hook. The default accepts, exactly as the model\r\n         * base's does; a class overrides it to react to its own changes.\r\n         */\r\n        OnModified() { return true; },\r\n\r\n        IsDirty() { return getRuntimeState(this)?.dirty === true; },\r\n        MarkDirty() { ensureRuntimeState(this).dirty = true; return this; },\r\n        ClearDirty() { const state = getRuntimeState(this); if (state) state.dirty = false; return this; }\r\n    };\r\n\r\n    return function (value, context)\r\n    {\r\n        if (context && typeof context === \"object\" && context.kind !== \"class\")\r\n        {\r\n            throw new TypeError(\"compose.values only supports classes.\");\r\n        }\r\n        if (typeof value !== \"function\")\r\n        {\r\n            throw new TypeError(\"compose.values requires a class constructor.\");\r\n        }\r\n\r\n        for (const [ name, method ] of Object.entries(METHODS))\r\n        {\r\n            if (name in value.prototype) continue;\r\n            Object.defineProperty(value.prototype, name, {\r\n                value: method,\r\n                writable: true,\r\n                configurable: true\r\n            });\r\n        }\r\n    };\r\n}\r\n"],"names":["MAX_UPDATE_PASSES","isWritableField","field","io","write","persist","persistOnly","read","createValuesTransport","services","GetFields","Export","Import","CoerceInto","IsEquivalent","getValues","target","out","options","constructor","name","setValues","values","changed","Set","Object","hasOwn","incoming","current","coerced","always","add","next","size","markDirty","ensureRuntimeState","dirty","skipUpdate","updateValues","returnBoolean","changedFields","state","updating","hook","OnModified","source","pass","Error","call","error","skipEvents","suppressEvents","HasListener","EmitEvent","composeValuesDecorator","transport","METHODS","GetValues","SetValues","UpdateValues","IsDirty","getRuntimeState","MarkDirty","ClearDirty","value","context","kind","TypeError","method","entries","prototype","defineProperty","writable","configurable"],"mappings":"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"}
+{"version":3,"file":"values.js","sources":["../../../../src/global/compose/values.js"],"sourcesContent":["// The values transport as COMPOSITION - the @compose.values decorator.\r\n//\r\n// Carbon keeps transport in SERVICES over its per-class VarEntry table:\r\n// BlackReader, the Copier and Python's getattr/setattr all drive Be::ClassInfo\r\n// from OUTSIDE the object, and no Blue base carries a GetValues. Ours put the\r\n// same work on a base class, which is what made `extends CjsModel` mandatory\r\n// for 886 classes and occupied the one `extends` slot JS has.\r\n//\r\n// `CjsSchema.getValues`/`setValues` are already the declared home - they exist\r\n// as statics forwarding to a registered service. The service's third arm, for\r\n// a decorated class carrying NEITHER method, threw by name:\r\n//\r\n//     \"CjsSchema.setValues on a plain decorated class awaits the facade\r\n//      migration's state-free transport.\"\r\n//\r\n// This module is that transport, and the decorator that installs it as\r\n// GetValues/SetValues on a class that wants the methods rather than the\r\n// statics. Nothing here touches CjsModel, so a class taking @compose.values\r\n// pays for none of the base.\r\n//\r\n// STATE IS LAZY, NOT ABSENT, and the distinction is the whole contract.\r\n// `setValues` does coercion, then the changed set, then dirty, then the settle\r\n// WITH the changed field names. The settle is one of the three benefits the\r\n// CjsModel audit found real - 95 classes override OnModified, and\r\n// TriValueBinding drives it per frame - so a transport that skipped it would\r\n// silently stop running every one of those bodies for any class that moved off\r\n// the base. The error message this module replaced said \"state-free\r\n// transport\"; that phrasing was a previous session's and contradicts the\r\n// decision page, which rules edit state LAZY: materialising on first write,\r\n// zero footprint until then.\r\n//\r\n// The mechanism is `ensureRuntimeState`, which creates the non-enumerable\r\n// `__state` slot only when it is not already there - the same slot\r\n// @compose.notify puts its listener map in, and the same one CjsModel fills\r\n// with a CjsModelState. An unedited object carries nothing.\r\n//\r\n// This module imports nothing from the SCHEMA layer, for the reason\r\n// compose/notify.js and compose/interface.js import nothing: CjsSchema installs\r\n// these onto its own namespace, so a schema import here is a cycle that fails\r\n// at load. Everything schema-shaped arrives through `services`. compose/\r\n// siblings are fine - they import nothing themselves.\r\n\r\nimport { ensureRuntimeState, getRuntimeState } from \"./runtimeState.js\";\r\n\r\n\r\n/** Bound for the JS values transport's cooperative settle. */\r\nconst MAX_UPDATE_PASSES = 32;\r\n\r\n/** Records a member before a deferred or reentrant values update returns. */\r\nexport function queueModifiedMember(target, propertyName)\r\n{\r\n    const state = ensureRuntimeState(target);\r\n    (state.pendingModified ??= new Set()).add(propertyName);\r\n}\r\n\r\n/**\r\n * JS values batching over Carbon's single-member INotify hook. The queue is\r\n * transport state, not class invalidation state. Callers apply their own\r\n * NOTIFY gate before recording a member. A null member preserves the existing\r\n * explicit, unnamed UpdateValues contract pending its separate policy review.\r\n */\r\nexport function settleModifiedMembers(target)\r\n{\r\n    const state = ensureRuntimeState(target);\r\n    if (state.updating) return true;\r\n    state.updating = true;\r\n    try\r\n    {\r\n        for (let pass = 0; ; pass++)\r\n        {\r\n            if (pass >= MAX_UPDATE_PASSES)\r\n            {\r\n                throw new Error(`${target.constructor.name} exceeded ${MAX_UPDATE_PASSES} settle passes.`);\r\n            }\r\n            const pending = state.pendingModified ?? new Set();\r\n            state.pendingModified = new Set();\r\n            state.dirty = false;\r\n            const members = Array.from(pending);\r\n            for (let index = 0; index < members.length; index++)\r\n            {\r\n                let accepted;\r\n                try\r\n                {\r\n                    accepted = typeof target.OnModified !== \"function\"\r\n                        || target.OnModified(members[index]) !== false;\r\n                }\r\n                catch (error)\r\n                {\r\n                    restore(index);\r\n                    throw error;\r\n                }\r\n                if (!accepted)\r\n                {\r\n                    restore(index);\r\n                    state.dirty = true;\r\n                    return false;\r\n                }\r\n            }\r\n            if (!state.pendingModified.size) break;\r\n\r\n            function restore(index)\r\n            {\r\n                const remaining = new Set();\r\n                for (; index < members.length; index++) remaining.add(members[index]);\r\n                for (const member of state.pendingModified) remaining.add(member);\r\n                state.pendingModified = remaining;\r\n            }\r\n        }\r\n        state.dirty = false;\r\n        return true;\r\n    }\r\n    catch (error)\r\n    {\r\n        state.dirty = true;\r\n        throw error;\r\n    }\r\n    finally\r\n    {\r\n        state.updating = false;\r\n    }\r\n}\r\n\r\n/**\r\n * Whether a declared field accepts an incoming value.\r\n *\r\n * The JS values import accepts WRITE, PERSIST and RPERSIST independently.\r\n * RPERSIST follows BlueTypes' load-only contract, including where the donor's\r\n * DictReader currently checks only PERSIST. This is a serialization service,\r\n * not BluePyWrap property access; unflagged declared fields retain JS support.\r\n *\r\n * @param {object} field\r\n * @returns {Boolean}\r\n */\r\nexport function isWritableField(field)\r\n{\r\n    const edit = field?.edit;\r\n    if (!edit) return true;\r\n    if (edit.write || edit.persist || edit.rpersist || edit.persistOnly) return true;\r\n    if (edit.read && !edit.write) return false;\r\n    return true;\r\n}\r\n\r\n\r\n/**\r\n * Selects persisted output by PERSIST, not RPERSIST.\r\n * The unrestricted JS values view retains all declared fields.\r\n * @param {object} field Declared field metadata.\r\n * @param {object} options Values export options.\r\n * @returns {boolean} Whether this field belongs in the exported values.\r\n */\r\nexport function isExportableField(field, options = {})\r\n{\r\n    const edit = field?.edit;\r\n    const persist = edit?.persist || edit?.persistOnly;\r\n    return !options.persistOnly || !!persist;\r\n}\r\n\r\n/**\r\n * Builds the state-free transport over a set of schema services.\r\n *\r\n * @param {object} services\r\n * @param {Function} services.GetFields Effective field records for a class.\r\n * @param {Function} services.Export Exports one declared value.\r\n * @param {Function} services.Import Coerces one incoming value.\r\n * @param {Function} services.CoerceInto In-place coercion; null when it does\r\n *     not apply, so the caller falls back to an allocating import.\r\n * @param {Function} services.IsEquivalent Compares two declared values.\r\n * @returns {{getValues: Function, setValues: Function}}\r\n */\r\nexport function createValuesTransport(services)\r\n{\r\n    const { GetFields, Export, Import, CoerceInto, IsEquivalent } = services;\r\n\r\n    /**\r\n     * Exports a decorated class's declared fields into a plain bag.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} [out] A bag the caller owns, for composing several\r\n     *     exports into one object - the reason the static carries `out` while\r\n     *     the instance method does not.\r\n     * @param {object} [options]\r\n     * @returns {object}\r\n     */\r\n    function getValues(target, out = {}, options = {})\r\n    {\r\n        for (const field of GetFields(target.constructor))\r\n        {\r\n            if (!isExportableField(field, options)) continue;\r\n            out[field.name] = Export(target[field.name], field, options);\r\n        }\r\n        return out;\r\n    }\r\n\r\n    /**\r\n     * Applies a plain bag to a decorated class's declared fields.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} [values]\r\n     * @param {object} [options]\r\n     * @returns {Set<String>|Boolean} The changed field names, or a boolean when\r\n     *     `options.returnBoolean` is set - the shape Carbon's Change and Set\r\n     *     methods return.\r\n     */\r\n    function setValues(target, values = {}, options = {})\r\n    {\r\n        const changed = new Set();\r\n        let notifyRequested = false;\r\n\r\n        for (const field of GetFields(target.constructor))\r\n        {\r\n            if (!isWritableField(field)) continue;\r\n            if (!Object.hasOwn(values, field.name)) continue;\r\n\r\n            const incoming = values[field.name];\r\n            const current = target[field.name];\r\n\r\n            // In place first, so a typed array keeps its identity and anything\r\n            // holding a reference to it keeps seeing live values.\r\n            const coerced = CoerceInto(current, incoming, field);\r\n            if (coerced !== null)\r\n            {\r\n                recordWrite(field, coerced);\r\n                continue;\r\n            }\r\n\r\n            const next = Import(incoming, field, options);\r\n            const didChange = !IsEquivalent(current, next);\r\n            target[field.name] = next;\r\n            recordWrite(field, didChange);\r\n        }\r\n\r\n        // Settle actual changes or explicitly requested equal-write notifications.\r\n        if ((changed.size || notifyRequested) && options.markDirty !== false)\r\n        {\r\n            if (options.skipUpdate !== true) updateValues(target, options, changed);\r\n        }\r\n\r\n        // Preserve each successful mutation if a later import or setter throws.\r\n        function recordWrite(field, didChange)\r\n        {\r\n            if (didChange) changed.add(field.name);\r\n            if (options.markDirty !== false)\r\n            {\r\n                if (didChange) ensureRuntimeState(target).dirty = true;\r\n                // BluePyWrap writes first, then tests NOTIFY without equality.\r\n                if (options.notify !== false && field.edit?.notify)\r\n                {\r\n                    queueModifiedMember(target, field.name);\r\n                    ensureRuntimeState(target).dirty = true;\r\n                    notifyRequested = true;\r\n                }\r\n            }\r\n        }\r\n\r\n        return options.returnBoolean === true ? changed.size > 0 : changed;\r\n    }\r\n\r\n    /**\r\n     * Settles queued single-member notifications and emits once after success.\r\n     *\r\n     * @param {object} target\r\n     * @param {object} options\r\n     * @param {Set<String>} changedFields\r\n     * @returns {Boolean} False when a hook refused, leaving the target dirty.\r\n     */\r\n    function updateValues(target, options, changedFields)\r\n    {\r\n        const state = ensureRuntimeState(target);\r\n        const properties = options.property ?? options.properties;\r\n        if (properties != null)\r\n        {\r\n            for (const name of typeof properties === \"string\" ? [properties] : properties)\r\n            {\r\n                queueModifiedMember(target, name);\r\n            }\r\n        }\r\n        else if (changedFields == null && (state.updating || !state.pendingModified?.size))\r\n        {\r\n            queueModifiedMember(target, null);\r\n        }\r\n        if (state.updating) return true;\r\n\r\n        // INotify is OPTIONAL, in Carbon as here: an object that does not\r\n        // implement the hook is simply never notified. The statics serve any\r\n        // decorated class, including ones that never took @compose.values and\r\n        // so have no OnModified - those settle trivially rather than throwing.\r\n        const hook = target.OnModified;\r\n        if (typeof hook !== \"function\")\r\n        {\r\n            state.pendingModified?.clear();\r\n            state.dirty = false;\r\n            return true;\r\n        }\r\n\r\n        const source = options.source ?? target;\r\n        if (!settleModifiedMembers(target)) return false;\r\n\r\n        // `HasListener` lives on the state slot itself, so it exists whatever\r\n        // decorators the class took, and answers false when no emitter was\r\n        // ever attached - which is also what keeps EmitEvent from being called\r\n        // on a class that does not have it.\r\n        //\r\n        // The emitter no-ops without listeners anyway, so the guard is really\r\n        // about the PAYLOAD: it stops one being built per settle for nobody,\r\n        // the waste the audit measured on the per-frame binding path.\r\n        if (options.skipEvents !== true && !state.suppressEvents && state.HasListener())\r\n        {\r\n            target.EmitEvent(\"modified\", target, { source, changedFields });\r\n        }\r\n\r\n        return true;\r\n    }\r\n\r\n    return { getValues, setValues, updateValues };\r\n}\r\n\r\n\r\n/**\r\n * The `@compose.values` class decorator.\r\n *\r\n * Installs `GetValues(options)` and `SetValues(values, options)` install-if-\r\n * absent, so a class that hand-rolls either keeps its own. The instance shapes\r\n * match the model's exactly: `GetValues` takes options only, because a fresh\r\n * bag is the only sensible target for `this`, while the static keeps `out`.\r\n *\r\n * @param {object} transport The transport from createValuesTransport.\r\n * @returns {Function} A stage-3 class decorator.\r\n */\r\nexport function composeValuesDecorator(transport)\r\n{\r\n    const METHODS = {\r\n        GetValues(options = {}) { return transport.getValues(this, {}, options); },\r\n        SetValues(values = {}, options = {}) { return transport.setValues(this, values, options); },\r\n        UpdateValues(options = {}) { return transport.updateValues(this, options, options.changedFields ?? null); },\r\n\r\n        /**\r\n         * Carbon's INotify hook. The default accepts, exactly as the model\r\n         * base's does; a class overrides it to react to its own changes.\r\n         */\r\n        OnModified() { return true; },\r\n\r\n        IsDirty() { return getRuntimeState(this)?.dirty === true; },\r\n        MarkDirty()\r\n        {\r\n            const state = ensureRuntimeState(this);\r\n            state.dirty = true;\r\n            if (state.updating) queueModifiedMember(this, null);\r\n            return this;\r\n        },\r\n        ClearDirty() { const state = getRuntimeState(this); if (state) state.dirty = false; return this; }\r\n    };\r\n\r\n    return function (value, context)\r\n    {\r\n        if (context && typeof context === \"object\" && context.kind !== \"class\")\r\n        {\r\n            throw new TypeError(\"compose.values only supports classes.\");\r\n        }\r\n        if (typeof value !== \"function\")\r\n        {\r\n            throw new TypeError(\"compose.values requires a class constructor.\");\r\n        }\r\n\r\n        for (const [ name, method ] of Object.entries(METHODS))\r\n        {\r\n            if (name in value.prototype) continue;\r\n            Object.defineProperty(value.prototype, name, {\r\n                value: method,\r\n                writable: true,\r\n                configurable: true\r\n            });\r\n        }\r\n    };\r\n}\r\n"],"names":["MAX_UPDATE_PASSES","queueModifiedMember","target","propertyName","state","ensureRuntimeState","pendingModified","Set","add","settleModifiedMembers","updating","pass","Error","constructor","name","pending","dirty","members","Array","from","index","length","accepted","OnModified","error","restore","size","remaining","member","isWritableField","field","edit","write","persist","rpersist","persistOnly","read","isExportableField","options","createValuesTransport","services","GetFields","Export","Import","CoerceInto","IsEquivalent","getValues","out","setValues","values","changed","notifyRequested","Object","hasOwn","incoming","current","coerced","recordWrite","next","didChange","markDirty","skipUpdate","updateValues","notify","returnBoolean","changedFields","properties","property","hook","clear","source","skipEvents","suppressEvents","HasListener","EmitEvent","composeValuesDecorator","transport","METHODS","GetValues","SetValues","UpdateValues","IsDirty","getRuntimeState","MarkDirty","ClearDirty","value","context","kind","TypeError","method","entries","prototype","defineProperty","writable","configurable"],"mappings":"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"}

package/dist/global/consts/blue.js

@@ -0,0 +1,73 @@
+// Source: blueexposure/include/IList.h:38-53
+// Source: blue/include/IBlueOS.h:48-53
+
+/**
+ * `BLUELISTEVENT` - what happened to a Blue list.
+ *
+ * A list holds ONE observer (`IListNotify* mNotify`, installed with SetNotify)
+ * and calls `OnListModified` on it. This is Carbon's wiring bus, not an event
+ * system: the observer is the owner reacting to its own list.
+ *
+ * The first seven are events; the last three are flags OR-ed on top, so mask
+ * with `BELIST_EVENTMASK` before comparing.
+ *
+ * IT LIVES HERE RATHER THAN ON ITS OWNER, AND ITS OWNER CANNOT REACH IT. The
+ * enum-placement rule makes a static on `IListNotify` the default, and that is
+ * where the vocabulary belongs. Two layer rules forbid it: `global/model` may
+ * not import `global/blue`, and `CjsModel` is what fires these; and
+ * `global/blue` may import only `global/schema`, so `IListNotify` cannot point
+ * back here either. There is therefore NO `IListNotify.BLUELISTEVENT` - this
+ * object is the only declaration, and `IListNotify` documents it in prose.
+ */
+const BLUELISTEVENT = Object.freeze({
+  /** After a read has filled the list - the one notification a load produces. */
+  BELIST_LOADFINISHED: 0x06,
+  /** Before a list is torn down. */
+  BELIST_UNLOADSTART: 0x07,
+  /** After insertion. */
+  BELIST_INSERTED: 0x08,
+  /** After removal. */
+  BELIST_REMOVED: 0x09,
+  /** After a swap. */
+  BELIST_SWAPPED: 0x0a,
+  /** After a move. */
+  BELIST_MOVED: 0x0c,
+  /** Masks the event out of a value carrying flags. */
+  BELIST_EVENTMASK: 0x0f,
+  // Flags. An owner that must ignore notifications during a load tests for
+  // BELIST_LOADING (EveEffectRoot2.cpp:90).
+  BELIST_LOADING: 0x10,
+  BELIST_UNLOADING: 0x20,
+  BELIST_FLAGMASK: 0xf0
+});
+
+/**
+ * `BLUEERROR` - the sentinel values `BeOS->SetError` accepts in place of an
+ * HRESULT.
+ *
+ * Three of the four are COMMANDS rather than errors: clear the log, flush it,
+ * or go and read the platform's own last error. Only `BEDEF` means "an error
+ * with nothing more specific to say".
+ *
+ * THE VOCABULARY IS PORTED, THE MECHANISM IS NOT. `IBlueOS.SetError` refuses
+ * here - error reporting is a real operating-system service with no consumer
+ * in this runtime - but a shared enum belongs in `global/consts` whether or
+ * not the verb that takes it is implemented, and declaring it is what makes
+ * the refusal reviewable rather than a blank.
+ *
+ * NEGATIVE ON PURPOSE. They share the space with HRESULT values, which is why
+ * they are small negatives Carbon's error codes cannot collide with.
+ */
+const BLUEERROR = Object.freeze({
+  /** Clears the error log. */
+  BECLEAR: 0,
+  /** No particular error value; the default. */
+  BEDEF: -1,
+  /** Go and call the platform's GetLastError. */
+  BE32: -2,
+  /** Flush the error log to the logger, then clear it. */
+  BEFLUSH: -3
+});
+
+export { BLUEERROR, BLUELISTEVENT };
+//# sourceMappingURL=blue.js.map

package/dist/global/consts/blue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blue.js","sources":["../../../../src/global/consts/blue.js"],"sourcesContent":["// Source: blueexposure/include/IList.h:38-53\n// Source: blue/include/IBlueOS.h:48-53\n\n/**\n * `BLUELISTEVENT` - what happened to a Blue list.\n *\n * A list holds ONE observer (`IListNotify* mNotify`, installed with SetNotify)\n * and calls `OnListModified` on it. This is Carbon's wiring bus, not an event\n * system: the observer is the owner reacting to its own list.\n *\n * The first seven are events; the last three are flags OR-ed on top, so mask\n * with `BELIST_EVENTMASK` before comparing.\n *\n * IT LIVES HERE RATHER THAN ON ITS OWNER, AND ITS OWNER CANNOT REACH IT. The\n * enum-placement rule makes a static on `IListNotify` the default, and that is\n * where the vocabulary belongs. Two layer rules forbid it: `global/model` may\n * not import `global/blue`, and `CjsModel` is what fires these; and\n * `global/blue` may import only `global/schema`, so `IListNotify` cannot point\n * back here either. There is therefore NO `IListNotify.BLUELISTEVENT` - this\n * object is the only declaration, and `IListNotify` documents it in prose.\n */\nexport const BLUELISTEVENT = Object.freeze({\n    /** After a read has filled the list - the one notification a load produces. */\n    BELIST_LOADFINISHED: 0x06,\n    /** Before a list is torn down. */\n    BELIST_UNLOADSTART: 0x07,\n    /** After insertion. */\n    BELIST_INSERTED: 0x08,\n    /** After removal. */\n    BELIST_REMOVED: 0x09,\n    /** After a swap. */\n    BELIST_SWAPPED: 0x0a,\n    /** After a move. */\n    BELIST_MOVED: 0x0c,\n    /** Masks the event out of a value carrying flags. */\n    BELIST_EVENTMASK: 0x0f,\n\n    // Flags. An owner that must ignore notifications during a load tests for\n    // BELIST_LOADING (EveEffectRoot2.cpp:90).\n    BELIST_LOADING: 0x10,\n    BELIST_UNLOADING: 0x20,\n    BELIST_FLAGMASK: 0xf0\n});\n\n\n/**\n * `BLUEERROR` - the sentinel values `BeOS->SetError` accepts in place of an\n * HRESULT.\n *\n * Three of the four are COMMANDS rather than errors: clear the log, flush it,\n * or go and read the platform's own last error. Only `BEDEF` means \"an error\n * with nothing more specific to say\".\n *\n * THE VOCABULARY IS PORTED, THE MECHANISM IS NOT. `IBlueOS.SetError` refuses\n * here - error reporting is a real operating-system service with no consumer\n * in this runtime - but a shared enum belongs in `global/consts` whether or\n * not the verb that takes it is implemented, and declaring it is what makes\n * the refusal reviewable rather than a blank.\n *\n * NEGATIVE ON PURPOSE. They share the space with HRESULT values, which is why\n * they are small negatives Carbon's error codes cannot collide with.\n */\nexport const BLUEERROR = Object.freeze({\n    /** Clears the error log. */\n    BECLEAR: 0,\n    /** No particular error value; the default. */\n    BEDEF: -1,\n    /** Go and call the platform's GetLastError. */\n    BE32: -2,\n    /** Flush the error log to the logger, then clear it. */\n    BEFLUSH: -3\n});\n"],"names":["BLUELISTEVENT","Object","freeze","BELIST_LOADFINISHED","BELIST_UNLOADSTART","BELIST_INSERTED","BELIST_REMOVED","BELIST_SWAPPED","BELIST_MOVED","BELIST_EVENTMASK","BELIST_LOADING","BELIST_UNLOADING","BELIST_FLAGMASK","BLUEERROR","BECLEAR","BEDEF","BE32","BEFLUSH"],"mappings":"AAAA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,aAAa,GAAGC,MAAM,CAACC,MAAM,CAAC;AACvC;AACAC,EAAAA,mBAAmB,EAAE,IAAI;AACzB;AACAC,EAAAA,kBAAkB,EAAE,IAAI;AACxB;AACAC,EAAAA,eAAe,EAAE,IAAI;AACrB;AACAC,EAAAA,cAAc,EAAE,IAAI;AACpB;AACAC,EAAAA,cAAc,EAAE,IAAI;AACpB;AACAC,EAAAA,YAAY,EAAE,IAAI;AAClB;AACAC,EAAAA,gBAAgB,EAAE,IAAI;AAEtB;AACA;AACAC,EAAAA,cAAc,EAAE,IAAI;AACpBC,EAAAA,gBAAgB,EAAE,IAAI;AACtBC,EAAAA,eAAe,EAAE;AACrB,CAAC;;AAGD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaC,SAAS,GAAGZ,MAAM,CAACC,MAAM,CAAC;AACnC;AACAY,EAAAA,OAAO,EAAE,CAAC;AACV;EACAC,KAAK,EAAE,EAAE;AACT;EACAC,IAAI,EAAE,EAAE;AACR;AACAC,EAAAA,OAAO,EAAE;AACb,CAAC;;;;"}

package/dist/global/consts/graphics/index.js

@@ -1,5 +1,5 @@
 export { PixelFormat, getPixelFormatBlockHeight, getPixelFormatBlockWidth, getPixelFormatBytesPerBlock, isCompressedPixelFormat, isSrgbPixelFormat, normalizePixelFormat } from './pixelFormats.js';
 export { ColorSpace, normalizeColorSpace } from './colorSpaces.js';
 export { TextureDimension, normalizeTextureDimension } from './textureDimensions.js';
-export { ReflectionMode, RenderingMode, TriBatchType, TriExtrapolation, TriOperator, TriTransformBase } from './trinityEnums.js';
+export { ReflectionMode, RenderingMode, TRIEXTRAPOLATION, TRIOPERATOR, TRITRANSFORMBASE, TriBatchType, TriStorageFlags } from './trinityEnums.js';
 //# sourceMappingURL=index.js.map

package/dist/global/consts/graphics/trinityEnums.js

@@ -17,9 +17,9 @@ const TriBatchType = Object.freeze({
   TRIBATCHTYPE_COUNT_OF_BATCH_TYPES: 14
 });
 
-/** Trinity standard render-state selector from Shader/Tr2EffectStateManager.h.
+/** Trinity standard render-state selector from Shader/Tr2EffectStateManager.h.
  * Cross-layer: Trinity batches/accumulators and engine dispatch both
- * key on it. Distinct from TriBatchType (batch bucket) — a render-state mode.
+ * key on it. Distinct from TriBatchType (batch bucket) — a render-state mode.
  * Unscoped Carbon enum: values are sequential from RM_ANY = 0. */
 const RenderingMode = Object.freeze({
   RM_ANY: 0,
@@ -48,14 +48,14 @@ const ReflectionMode = Object.freeze({
 });
 
 /** Trinity graph value-combination operator from blue/include/ITriConstants.h. */
-const TriOperator = Object.freeze({
+const TRIOPERATOR = Object.freeze({
   TRIOP_MULTIPLY: 0,
   TRIOP_ADD: 1,
   TRIOP_AVERAGE: 2
 });
 
 /** Trinity transform-parameter base frame from blue/include/ITriConstants.h. */
-const TriTransformBase = Object.freeze({
+const TRITRANSFORMBASE = Object.freeze({
   TRITB_OBJECT: 0,
   TRITB_CAMERA_ROTATION: 1,
   TRITB_CAMERA_TRANSLATION: 2,
@@ -78,13 +78,25 @@ const TriTransformBase = Object.freeze({
 
 // Carbon TRIEXTRAPOLATION (blue/include/ITriConstants.h:33) - curve
 // extrapolation modes, shared by trinity curves (TriEventCurve) and audio
-// (AudEventCurve). Class statics alias this export (TriOperator pattern).
-const TriExtrapolation = Object.freeze({
+// (AudEventCurve). Class statics alias this export (TRIOPERATOR pattern).
+const TRIEXTRAPOLATION = Object.freeze({
   TRIEXT_NONE: 0,
   TRIEXT_CONSTANT: 1,
   TRIEXT_GRADIENT: 2,
   TRIEXT_CYCLE: 3
 });
 
-export { ReflectionMode, RenderingMode, TriBatchType, TriExtrapolation, TriOperator, TriTransformBase };
+/** Storage classes a device resource may be released from, Tr2DeviceResource.h:7-15.
+ * A release takes a mask: VIDEOMEMORY for a device reset, MANAGEDMEMORY for
+ * device-memory resources, ALL for teardown. Unscoped Carbon enum, so the
+ * members carry their full names and their bit values. The mask parameter's
+ * own type is Carbon's `typedef unsigned int TriStorage`; the enum is
+ * `TriStorageFlags`. */
+const TriStorageFlags = Object.freeze({
+  TRISTORAGE_VIDEOMEMORY: 1 << 0,
+  TRISTORAGE_MANAGEDMEMORY: 1 << 1,
+  TRISTORAGE_ALL: (1 << 2) - 1
+});
+
+export { ReflectionMode, RenderingMode, TRIEXTRAPOLATION, TRIOPERATOR, TRITRANSFORMBASE, TriBatchType, TriStorageFlags };
 //# sourceMappingURL=trinityEnums.js.map

package/dist/global/consts/graphics/trinityEnums.js.map

@@ -1 +1 @@
-{"version":3,"file":"trinityEnums.js","sources":["../../../../../src/global/consts/graphics/trinityEnums.js"],"sourcesContent":["/** Global Trinity render-batch vocabulary from ITr2Renderable.h. */\r\nexport const TriBatchType = Object.freeze({\r\n    TRIBATCHTYPE_OPAQUE: 0,\r\n    TRIBATCHTYPE_DECAL: 1,\r\n    TRIBATCHTYPE_TRANSPARENT: 2,\r\n    TRIBATCHTYPE_DEPTH: 3,\r\n    TRIBATCHTYPE_ADDITIVE: 4,\r\n    TRIBATCHTYPE_PICKING: 5,\r\n    TRIBATCHTYPE_MIRROR: 6,\r\n    TRIBATCHTYPE_DECALNORMAL: 7,\r\n    TRIBATCHTYPE_DEPTHNORMAL: 8,\r\n    TRIBATCHTYPE_OPAQUE_PREPASS: 9,\r\n    TRIBATCHTYPE_DECAL_PREPASS: 10,\r\n    TRIBATCHTYPE_GEOMETRY_ERASER: 11,\r\n    TRIBATCHTYPE_FLARE: 12,\r\n    TRIBATCHTYPE_DISTORTION: 13,\r\n    TRIBATCHTYPE_COUNT_OF_BATCH_TYPES: 14\r\n});\r\n\r\n/** Trinity standard render-state selector from Shader/Tr2EffectStateManager.h.\r\n * Cross-layer: Trinity batches/accumulators and engine dispatch both\n * key on it. Distinct from TriBatchType (batch bucket) — a render-state mode.\r\n * Unscoped Carbon enum: values are sequential from RM_ANY = 0. */\r\nexport const RenderingMode = Object.freeze({\r\n    RM_ANY: 0,\r\n    RM_OPAQUE: 1,\r\n    RM_DECAL: 2,\r\n    RM_DECAL_NO_DEPTH: 3,\r\n    RM_ALPHA: 4,\r\n    RM_ALPHA_ADDITIVE: 5,\r\n    RM_DEPTH_ONLY: 6,\r\n    RM_PICKING: 7,\r\n    RM_FULLSCREEN: 8,\r\n    RM_SPRITE2D: 9,\r\n    RM_CULL: 10,\r\n    RM_LIGHT: 11,\r\n    RM_ERASE: 12,\r\n    RM_PREPASS_COLOR: 13,\r\n    RM_COUNT: 14\r\n});\r\n\r\n/** Shared EVE entity reflection vocabulary from EntityComponents. */\r\nexport const ReflectionMode = Object.freeze({\r\n    REFLECT_HIGH: 0,\r\n    REFLECT_MEDIUM_AND_HIGH: 1,\r\n    REFLECT_LOW_MEDIUM_HIGH: 2,\r\n    REFLECT_NEVER: 3\r\n});\r\n\r\n/** Trinity graph value-combination operator from blue/include/ITriConstants.h. */\r\nexport const TriOperator = Object.freeze({\r\n    TRIOP_MULTIPLY: 0,\r\n    TRIOP_ADD: 1,\r\n    TRIOP_AVERAGE: 2\r\n});\r\n\r\n/** Trinity transform-parameter base frame from blue/include/ITriConstants.h. */\r\nexport const TriTransformBase = Object.freeze({\r\n    TRITB_OBJECT: 0,\r\n    TRITB_CAMERA_ROTATION: 1,\r\n    TRITB_CAMERA_TRANSLATION: 2,\r\n    TRITB_CAMERA: 3,\r\n    TRITB_CAMERA_ROTATION_ALIGNED: 4,\r\n    TRITB_FIXED: 5,\r\n    TRITB_CAMERA_ROTATION_FALLOFF: 6,\r\n    TRITB_CAMERA_ROTATION_ALIGNED_SYMMETRY: 7,\r\n    TRITB_CAMERA_ROTATION_FALLOFF_SYMMETRY: 8,\r\n    TRITB_BOOSTER: 9,\r\n    TRITB_SIMPLE_HALO: 10,\r\n    TRITB_SIMPLE_HALO_SYMMETRY: 11,\r\n    TRITB_BOOSTER_FALLOFF: 12,\r\n    TRITB_WORLD: 13,\r\n    TRITB_SIMPLE_HALO_FALLOFF: 14,\r\n    TRITB_SIMPLE_SPRITE: 15,\r\n    TRITB_SIMPLE_SPRITE_FALLOFF: 16,\r\n    TRITB_SIMPLE_SPRITE_CONSTANT: 17\r\n});\r\n\r\n// Carbon TRIEXTRAPOLATION (blue/include/ITriConstants.h:33) - curve\r\n// extrapolation modes, shared by trinity curves (TriEventCurve) and audio\r\n// (AudEventCurve). Class statics alias this export (TriOperator pattern).\r\nexport const TriExtrapolation = Object.freeze({\r\n    TRIEXT_NONE: 0,\r\n    TRIEXT_CONSTANT: 1,\r\n    TRIEXT_GRADIENT: 2,\r\n    TRIEXT_CYCLE: 3\r\n});\r\n"],"names":["TriBatchType","Object","freeze","TRIBATCHTYPE_OPAQUE","TRIBATCHTYPE_DECAL","TRIBATCHTYPE_TRANSPARENT","TRIBATCHTYPE_DEPTH","TRIBATCHTYPE_ADDITIVE","TRIBATCHTYPE_PICKING","TRIBATCHTYPE_MIRROR","TRIBATCHTYPE_DECALNORMAL","TRIBATCHTYPE_DEPTHNORMAL","TRIBATCHTYPE_OPAQUE_PREPASS","TRIBATCHTYPE_DECAL_PREPASS","TRIBATCHTYPE_GEOMETRY_ERASER","TRIBATCHTYPE_FLARE","TRIBATCHTYPE_DISTORTION","TRIBATCHTYPE_COUNT_OF_BATCH_TYPES","RenderingMode","RM_ANY","RM_OPAQUE","RM_DECAL","RM_DECAL_NO_DEPTH","RM_ALPHA","RM_ALPHA_ADDITIVE","RM_DEPTH_ONLY","RM_PICKING","RM_FULLSCREEN","RM_SPRITE2D","RM_CULL","RM_LIGHT","RM_ERASE","RM_PREPASS_COLOR","RM_COUNT","ReflectionMode","REFLECT_HIGH","REFLECT_MEDIUM_AND_HIGH","REFLECT_LOW_MEDIUM_HIGH","REFLECT_NEVER","TriOperator","TRIOP_MULTIPLY","TRIOP_ADD","TRIOP_AVERAGE","TriTransformBase","TRITB_OBJECT","TRITB_CAMERA_ROTATION","TRITB_CAMERA_TRANSLATION","TRITB_CAMERA","TRITB_CAMERA_ROTATION_ALIGNED","TRITB_FIXED","TRITB_CAMERA_ROTATION_FALLOFF","TRITB_CAMERA_ROTATION_ALIGNED_SYMMETRY","TRITB_CAMERA_ROTATION_FALLOFF_SYMMETRY","TRITB_BOOSTER","TRITB_SIMPLE_HALO","TRITB_SIMPLE_HALO_SYMMETRY","TRITB_BOOSTER_FALLOFF","TRITB_WORLD","TRITB_SIMPLE_HALO_FALLOFF","TRITB_SIMPLE_SPRITE","TRITB_SIMPLE_SPRITE_FALLOFF","TRITB_SIMPLE_SPRITE_CONSTANT","TriExtrapolation","TRIEXT_NONE","TRIEXT_CONSTANT","TRIEXT_GRADIENT","TRIEXT_CYCLE"],"mappings":"AAAA;MACaA,YAAY,GAAGC,MAAM,CAACC,MAAM,CAAC;AACtCC,EAAAA,mBAAmB,EAAE,CAAC;AACtBC,EAAAA,kBAAkB,EAAE,CAAC;AACrBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,kBAAkB,EAAE,CAAC;AACrBC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,oBAAoB,EAAE,CAAC;AACvBC,EAAAA,mBAAmB,EAAE,CAAC;AACtBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,2BAA2B,EAAE,CAAC;AAC9BC,EAAAA,0BAA0B,EAAE,EAAE;AAC9BC,EAAAA,4BAA4B,EAAE,EAAE;AAChCC,EAAAA,kBAAkB,EAAE,EAAE;AACtBC,EAAAA,uBAAuB,EAAE,EAAE;AAC3BC,EAAAA,iCAAiC,EAAE;AACvC,CAAC;;AAED;AACA;AACA;AACA;MACaC,aAAa,GAAGjB,MAAM,CAACC,MAAM,CAAC;AACvCiB,EAAAA,MAAM,EAAE,CAAC;AACTC,EAAAA,SAAS,EAAE,CAAC;AACZC,EAAAA,QAAQ,EAAE,CAAC;AACXC,EAAAA,iBAAiB,EAAE,CAAC;AACpBC,EAAAA,QAAQ,EAAE,CAAC;AACXC,EAAAA,iBAAiB,EAAE,CAAC;AACpBC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,UAAU,EAAE,CAAC;AACbC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,OAAO,EAAE,EAAE;AACXC,EAAAA,QAAQ,EAAE,EAAE;AACZC,EAAAA,QAAQ,EAAE,EAAE;AACZC,EAAAA,gBAAgB,EAAE,EAAE;AACpBC,EAAAA,QAAQ,EAAE;AACd,CAAC;;AAED;MACaC,cAAc,GAAGjC,MAAM,CAACC,MAAM,CAAC;AACxCiC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,uBAAuB,EAAE,CAAC;AAC1BC,EAAAA,uBAAuB,EAAE,CAAC;AAC1BC,EAAAA,aAAa,EAAE;AACnB,CAAC;;AAED;MACaC,WAAW,GAAGtC,MAAM,CAACC,MAAM,CAAC;AACrCsC,EAAAA,cAAc,EAAE,CAAC;AACjBC,EAAAA,SAAS,EAAE,CAAC;AACZC,EAAAA,aAAa,EAAE;AACnB,CAAC;;AAED;MACaC,gBAAgB,GAAG1C,MAAM,CAACC,MAAM,CAAC;AAC1C0C,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,6BAA6B,EAAE,CAAC;AAChCC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,6BAA6B,EAAE,CAAC;AAChCC,EAAAA,sCAAsC,EAAE,CAAC;AACzCC,EAAAA,sCAAsC,EAAE,CAAC;AACzCC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,iBAAiB,EAAE,EAAE;AACrBC,EAAAA,0BAA0B,EAAE,EAAE;AAC9BC,EAAAA,qBAAqB,EAAE,EAAE;AACzBC,EAAAA,WAAW,EAAE,EAAE;AACfC,EAAAA,yBAAyB,EAAE,EAAE;AAC7BC,EAAAA,mBAAmB,EAAE,EAAE;AACvBC,EAAAA,2BAA2B,EAAE,EAAE;AAC/BC,EAAAA,4BAA4B,EAAE;AAClC,CAAC;;AAED;AACA;AACA;MACaC,gBAAgB,GAAG7D,MAAM,CAACC,MAAM,CAAC;AAC1C6D,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,eAAe,EAAE,CAAC;AAClBC,EAAAA,eAAe,EAAE,CAAC;AAClBC,EAAAA,YAAY,EAAE;AAClB,CAAC;;;;"}
+{"version":3,"file":"trinityEnums.js","sources":["../../../../../src/global/consts/graphics/trinityEnums.js"],"sourcesContent":["/** Global Trinity render-batch vocabulary from ITr2Renderable.h. */\nexport const TriBatchType = Object.freeze({\n    TRIBATCHTYPE_OPAQUE: 0,\n    TRIBATCHTYPE_DECAL: 1,\n    TRIBATCHTYPE_TRANSPARENT: 2,\n    TRIBATCHTYPE_DEPTH: 3,\n    TRIBATCHTYPE_ADDITIVE: 4,\n    TRIBATCHTYPE_PICKING: 5,\n    TRIBATCHTYPE_MIRROR: 6,\n    TRIBATCHTYPE_DECALNORMAL: 7,\n    TRIBATCHTYPE_DEPTHNORMAL: 8,\n    TRIBATCHTYPE_OPAQUE_PREPASS: 9,\n    TRIBATCHTYPE_DECAL_PREPASS: 10,\n    TRIBATCHTYPE_GEOMETRY_ERASER: 11,\n    TRIBATCHTYPE_FLARE: 12,\n    TRIBATCHTYPE_DISTORTION: 13,\n    TRIBATCHTYPE_COUNT_OF_BATCH_TYPES: 14\n});\n\n/** Trinity standard render-state selector from Shader/Tr2EffectStateManager.h.\n * Cross-layer: Trinity batches/accumulators and engine dispatch both\n * key on it. Distinct from TriBatchType (batch bucket) — a render-state mode.\n * Unscoped Carbon enum: values are sequential from RM_ANY = 0. */\nexport const RenderingMode = Object.freeze({\n    RM_ANY: 0,\n    RM_OPAQUE: 1,\n    RM_DECAL: 2,\n    RM_DECAL_NO_DEPTH: 3,\n    RM_ALPHA: 4,\n    RM_ALPHA_ADDITIVE: 5,\n    RM_DEPTH_ONLY: 6,\n    RM_PICKING: 7,\n    RM_FULLSCREEN: 8,\n    RM_SPRITE2D: 9,\n    RM_CULL: 10,\n    RM_LIGHT: 11,\n    RM_ERASE: 12,\n    RM_PREPASS_COLOR: 13,\n    RM_COUNT: 14\n});\n\n/** Shared EVE entity reflection vocabulary from EntityComponents. */\nexport const ReflectionMode = Object.freeze({\n    REFLECT_HIGH: 0,\n    REFLECT_MEDIUM_AND_HIGH: 1,\n    REFLECT_LOW_MEDIUM_HIGH: 2,\n    REFLECT_NEVER: 3\n});\n\n/** Trinity graph value-combination operator from blue/include/ITriConstants.h. */\nexport const TRIOPERATOR = Object.freeze({\n    TRIOP_MULTIPLY: 0,\n    TRIOP_ADD: 1,\n    TRIOP_AVERAGE: 2\n});\n\n/** Trinity transform-parameter base frame from blue/include/ITriConstants.h. */\nexport const TRITRANSFORMBASE = Object.freeze({\n    TRITB_OBJECT: 0,\n    TRITB_CAMERA_ROTATION: 1,\n    TRITB_CAMERA_TRANSLATION: 2,\n    TRITB_CAMERA: 3,\n    TRITB_CAMERA_ROTATION_ALIGNED: 4,\n    TRITB_FIXED: 5,\n    TRITB_CAMERA_ROTATION_FALLOFF: 6,\n    TRITB_CAMERA_ROTATION_ALIGNED_SYMMETRY: 7,\n    TRITB_CAMERA_ROTATION_FALLOFF_SYMMETRY: 8,\n    TRITB_BOOSTER: 9,\n    TRITB_SIMPLE_HALO: 10,\n    TRITB_SIMPLE_HALO_SYMMETRY: 11,\n    TRITB_BOOSTER_FALLOFF: 12,\n    TRITB_WORLD: 13,\n    TRITB_SIMPLE_HALO_FALLOFF: 14,\n    TRITB_SIMPLE_SPRITE: 15,\n    TRITB_SIMPLE_SPRITE_FALLOFF: 16,\n    TRITB_SIMPLE_SPRITE_CONSTANT: 17\n});\n\n// Carbon TRIEXTRAPOLATION (blue/include/ITriConstants.h:33) - curve\n// extrapolation modes, shared by trinity curves (TriEventCurve) and audio\n// (AudEventCurve). Class statics alias this export (TRIOPERATOR pattern).\nexport const TRIEXTRAPOLATION = Object.freeze({\n    TRIEXT_NONE: 0,\n    TRIEXT_CONSTANT: 1,\n    TRIEXT_GRADIENT: 2,\n    TRIEXT_CYCLE: 3\n});\n\n/** Storage classes a device resource may be released from, Tr2DeviceResource.h:7-15.\n * A release takes a mask: VIDEOMEMORY for a device reset, MANAGEDMEMORY for\n * device-memory resources, ALL for teardown. Unscoped Carbon enum, so the\n * members carry their full names and their bit values. The mask parameter's\n * own type is Carbon's `typedef unsigned int TriStorage`; the enum is\n * `TriStorageFlags`. */\nexport const TriStorageFlags = Object.freeze({\n    TRISTORAGE_VIDEOMEMORY: 1 << 0,\n    TRISTORAGE_MANAGEDMEMORY: 1 << 1,\n    TRISTORAGE_ALL: (1 << 2) - 1\n});\n"],"names":["TriBatchType","Object","freeze","TRIBATCHTYPE_OPAQUE","TRIBATCHTYPE_DECAL","TRIBATCHTYPE_TRANSPARENT","TRIBATCHTYPE_DEPTH","TRIBATCHTYPE_ADDITIVE","TRIBATCHTYPE_PICKING","TRIBATCHTYPE_MIRROR","TRIBATCHTYPE_DECALNORMAL","TRIBATCHTYPE_DEPTHNORMAL","TRIBATCHTYPE_OPAQUE_PREPASS","TRIBATCHTYPE_DECAL_PREPASS","TRIBATCHTYPE_GEOMETRY_ERASER","TRIBATCHTYPE_FLARE","TRIBATCHTYPE_DISTORTION","TRIBATCHTYPE_COUNT_OF_BATCH_TYPES","RenderingMode","RM_ANY","RM_OPAQUE","RM_DECAL","RM_DECAL_NO_DEPTH","RM_ALPHA","RM_ALPHA_ADDITIVE","RM_DEPTH_ONLY","RM_PICKING","RM_FULLSCREEN","RM_SPRITE2D","RM_CULL","RM_LIGHT","RM_ERASE","RM_PREPASS_COLOR","RM_COUNT","ReflectionMode","REFLECT_HIGH","REFLECT_MEDIUM_AND_HIGH","REFLECT_LOW_MEDIUM_HIGH","REFLECT_NEVER","TRIOPERATOR","TRIOP_MULTIPLY","TRIOP_ADD","TRIOP_AVERAGE","TRITRANSFORMBASE","TRITB_OBJECT","TRITB_CAMERA_ROTATION","TRITB_CAMERA_TRANSLATION","TRITB_CAMERA","TRITB_CAMERA_ROTATION_ALIGNED","TRITB_FIXED","TRITB_CAMERA_ROTATION_FALLOFF","TRITB_CAMERA_ROTATION_ALIGNED_SYMMETRY","TRITB_CAMERA_ROTATION_FALLOFF_SYMMETRY","TRITB_BOOSTER","TRITB_SIMPLE_HALO","TRITB_SIMPLE_HALO_SYMMETRY","TRITB_BOOSTER_FALLOFF","TRITB_WORLD","TRITB_SIMPLE_HALO_FALLOFF","TRITB_SIMPLE_SPRITE","TRITB_SIMPLE_SPRITE_FALLOFF","TRITB_SIMPLE_SPRITE_CONSTANT","TRIEXTRAPOLATION","TRIEXT_NONE","TRIEXT_CONSTANT","TRIEXT_GRADIENT","TRIEXT_CYCLE","TriStorageFlags","TRISTORAGE_VIDEOMEMORY","TRISTORAGE_MANAGEDMEMORY","TRISTORAGE_ALL"],"mappings":"AAAA;MACaA,YAAY,GAAGC,MAAM,CAACC,MAAM,CAAC;AACtCC,EAAAA,mBAAmB,EAAE,CAAC;AACtBC,EAAAA,kBAAkB,EAAE,CAAC;AACrBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,kBAAkB,EAAE,CAAC;AACrBC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,oBAAoB,EAAE,CAAC;AACvBC,EAAAA,mBAAmB,EAAE,CAAC;AACtBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,2BAA2B,EAAE,CAAC;AAC9BC,EAAAA,0BAA0B,EAAE,EAAE;AAC9BC,EAAAA,4BAA4B,EAAE,EAAE;AAChCC,EAAAA,kBAAkB,EAAE,EAAE;AACtBC,EAAAA,uBAAuB,EAAE,EAAE;AAC3BC,EAAAA,iCAAiC,EAAE;AACvC,CAAC;;AAED;AACA;AACA;AACA;MACaC,aAAa,GAAGjB,MAAM,CAACC,MAAM,CAAC;AACvCiB,EAAAA,MAAM,EAAE,CAAC;AACTC,EAAAA,SAAS,EAAE,CAAC;AACZC,EAAAA,QAAQ,EAAE,CAAC;AACXC,EAAAA,iBAAiB,EAAE,CAAC;AACpBC,EAAAA,QAAQ,EAAE,CAAC;AACXC,EAAAA,iBAAiB,EAAE,CAAC;AACpBC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,UAAU,EAAE,CAAC;AACbC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,OAAO,EAAE,EAAE;AACXC,EAAAA,QAAQ,EAAE,EAAE;AACZC,EAAAA,QAAQ,EAAE,EAAE;AACZC,EAAAA,gBAAgB,EAAE,EAAE;AACpBC,EAAAA,QAAQ,EAAE;AACd,CAAC;;AAED;MACaC,cAAc,GAAGjC,MAAM,CAACC,MAAM,CAAC;AACxCiC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,uBAAuB,EAAE,CAAC;AAC1BC,EAAAA,uBAAuB,EAAE,CAAC;AAC1BC,EAAAA,aAAa,EAAE;AACnB,CAAC;;AAED;MACaC,WAAW,GAAGtC,MAAM,CAACC,MAAM,CAAC;AACrCsC,EAAAA,cAAc,EAAE,CAAC;AACjBC,EAAAA,SAAS,EAAE,CAAC;AACZC,EAAAA,aAAa,EAAE;AACnB,CAAC;;AAED;MACaC,gBAAgB,GAAG1C,MAAM,CAACC,MAAM,CAAC;AAC1C0C,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,qBAAqB,EAAE,CAAC;AACxBC,EAAAA,wBAAwB,EAAE,CAAC;AAC3BC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,6BAA6B,EAAE,CAAC;AAChCC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,6BAA6B,EAAE,CAAC;AAChCC,EAAAA,sCAAsC,EAAE,CAAC;AACzCC,EAAAA,sCAAsC,EAAE,CAAC;AACzCC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,iBAAiB,EAAE,EAAE;AACrBC,EAAAA,0BAA0B,EAAE,EAAE;AAC9BC,EAAAA,qBAAqB,EAAE,EAAE;AACzBC,EAAAA,WAAW,EAAE,EAAE;AACfC,EAAAA,yBAAyB,EAAE,EAAE;AAC7BC,EAAAA,mBAAmB,EAAE,EAAE;AACvBC,EAAAA,2BAA2B,EAAE,EAAE;AAC/BC,EAAAA,4BAA4B,EAAE;AAClC,CAAC;;AAED;AACA;AACA;MACaC,gBAAgB,GAAG7D,MAAM,CAACC,MAAM,CAAC;AAC1C6D,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,eAAe,EAAE,CAAC;AAClBC,EAAAA,eAAe,EAAE,CAAC;AAClBC,EAAAA,YAAY,EAAE;AAClB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;MACaC,eAAe,GAAGlE,MAAM,CAACC,MAAM,CAAC;EACzCkE,sBAAsB,EAAE,CAAC,IAAI,CAAC;EAC9BC,wBAAwB,EAAE,CAAC,IAAI,CAAC;AAChCC,EAAAA,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI;AAC/B,CAAC;;;;"}

package/dist/global/consts/index.js

@@ -2,11 +2,12 @@ export { MediaType, PayloadType, normalizeMediaType, normalizePayloadType } from
 export { PixelFormat, getPixelFormatBlockHeight, getPixelFormatBlockWidth, getPixelFormatBytesPerBlock, isCompressedPixelFormat, isSrgbPixelFormat, normalizePixelFormat } from './graphics/pixelFormats.js';
 export { ColorSpace, normalizeColorSpace } from './graphics/colorSpaces.js';
 export { TextureDimension, normalizeTextureDimension } from './graphics/textureDimensions.js';
-export { ReflectionMode, RenderingMode, TriBatchType, TriExtrapolation, TriOperator, TriTransformBase } from './graphics/trinityEnums.js';
+export { ReflectionMode, RenderingMode, TRIEXTRAPOLATION, TRIOPERATOR, TRITRANSFORMBASE, TriBatchType, TriStorageFlags } from './graphics/trinityEnums.js';
 export { AudioChannelLayout, AudioSampleFormat, normalizeAudioSampleFormat } from './audio/audioFormats.js';
 export { ShaderModel, ShaderStage, normalizeShaderStage } from './shader/shaderStages.js';
 export { DxgiFormat, normalizeDxgiFormat } from './d3d/dxgiFormats.js';
 export { D3dPrimitiveTopology } from './d3d/primitiveTopology.js';
 export { CarbonPixelFormatToWebGpu, DxgiFormatToPixelFormat, GpuTextureFormat, PixelFormatToWebGpu, SrgbSiblingOf, dxgiToPixelFormat, toWebGpuTextureFormat } from './webgpu/textureFormats.js';
+export { BLUEERROR, BLUELISTEVENT } from './blue.js';
 export { Tr2Lod } from './trinity.js';
 //# sourceMappingURL=index.js.map

package/dist/global/consts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;"}

package/dist/global/consts/trinity.js.map

@@ -1 +1 @@
-{"version":3,"file":"trinity.js","sources":["../../../../src/global/consts/trinity.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LodResource.h\r\n\r\n/**\r\n * Shared Trinity level-of-detail values.\r\n */\r\nexport const Tr2Lod = Object.freeze({\r\n    TR2_LOD_UNSPECIFIED: -1,\r\n    TR2_LOD_LOW: 0,\r\n    TR2_LOD_MEDIUM: 1,\r\n    TR2_LOD_HIGH: 2,\r\n    TR2_LOD_ULTRA: 3,\r\n    TR2_LOD_COUNT: 4\r\n});\r\n"],"names":["Tr2Lod","Object","freeze","TR2_LOD_UNSPECIFIED","TR2_LOD_LOW","TR2_LOD_MEDIUM","TR2_LOD_HIGH","TR2_LOD_ULTRA","TR2_LOD_COUNT"],"mappings":"AAAA;;AAEA;AACA;AACA;MACaA,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;EAChCC,mBAAmB,EAAE,EAAE;AACvBC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,cAAc,EAAE,CAAC;AACjBC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,aAAa,EAAE;AACnB,CAAC;;;;"}
+{"version":3,"file":"trinity.js","sources":["../../../../src/global/consts/trinity.js"],"sourcesContent":["// Source: trinity/trinity/Resources/Tr2LodResource.h\r\n\r\n/**\r\n * Shared Trinity level-of-detail values.\r\n */\r\nexport const Tr2Lod = Object.freeze({\r\n    TR2_LOD_UNSPECIFIED: -1,\r\n    TR2_LOD_LOW: 0,\r\n    TR2_LOD_MEDIUM: 1,\r\n    TR2_LOD_HIGH: 2,\r\n    TR2_LOD_ULTRA: 3,\r\n    TR2_LOD_COUNT: 4\r\n});\r\n\n"],"names":["Tr2Lod","Object","freeze","TR2_LOD_UNSPECIFIED","TR2_LOD_LOW","TR2_LOD_MEDIUM","TR2_LOD_HIGH","TR2_LOD_ULTRA","TR2_LOD_COUNT"],"mappings":"AAAA;;AAEA;AACA;AACA;MACaA,MAAM,GAAGC,MAAM,CAACC,MAAM,CAAC;EAChCC,mBAAmB,EAAE,EAAE;AACvBC,EAAAA,WAAW,EAAE,CAAC;AACdC,EAAAA,cAAc,EAAE,CAAC;AACjBC,EAAAA,YAAY,EAAE,CAAC;AACfC,EAAAA,aAAa,EAAE,CAAC;AAChBC,EAAAA,aAAa,EAAE;AACnB,CAAC;;;;"}

package/dist/global/contracts/ITr2BoundingBox.js

@@ -1,16 +1,10 @@
 import { impl } from '../schema/index.js';
 import { CjsSchema } from '../schema/CjsSchema.js';
 
-const ITR2_BOUNDING_BOX = Symbol.for("carbonenginejs.contract.ITr2BoundingBox");
-
 /**
  * Dependency-free contract for objects that publish a ready world-space axis-aligned bounding box.
  */
 class ITr2BoundingBox {
-  static [Symbol.hasInstance](value) {
-    return value !== null && value !== undefined && value[ITR2_BOUNDING_BOX] === true;
-  }
-
   /** Writes the current world-space minimum and maximum bounds. */
   GetWorldBoundingBox(_minBounds, _maxBounds) {
     throw new Error("ITr2BoundingBox.GetWorldBoundingBox must be implemented by a bounding-box provider.");
@@ -21,38 +15,11 @@ class ITr2BoundingBox {
     throw new Error("ITr2BoundingBox.IsBoundingBoxReady must be implemented by a bounding-box provider.");
   }
 }
-Object.defineProperty(ITr2BoundingBox.prototype, ITR2_BOUNDING_BOX, {
-  value: true
-});
 CjsSchema.decorateMethod(ITr2BoundingBox, "GetWorldBoundingBox", impl.abstract);
 CjsSchema.decorateMethod(ITr2BoundingBox, "IsBoundingBoxReady", impl.abstract);
 CjsSchema.define(ITr2BoundingBox, {
   className: "ITr2BoundingBox"
 });
 
-/**
- * Adds the dependency-free ITr2BoundingBox contract to an existing model base
- * without replacing that base's JavaScript inheritance chain.
- */
-function withITr2BoundingBox(Base) {
-  const Provider = class extends Base {
-    /** Delegates to the required world-bounds implementation. */
-    GetWorldBoundingBox(minBounds, maxBounds) {
-      return ITr2BoundingBox.prototype.GetWorldBoundingBox.call(this, minBounds, maxBounds);
-    }
-
-    /** Delegates to the required bounds-readiness implementation. */
-    IsBoundingBoxReady() {
-      return ITr2BoundingBox.prototype.IsBoundingBoxReady.call(this);
-    }
-  };
-  Object.defineProperty(Provider.prototype, ITR2_BOUNDING_BOX, {
-    value: true
-  });
-  CjsSchema.decorateMethod(Provider, "GetWorldBoundingBox", impl.abstract);
-  CjsSchema.decorateMethod(Provider, "IsBoundingBoxReady", impl.abstract);
-  return Provider;
-}
-
-export { ITr2BoundingBox, withITr2BoundingBox };
+export { ITr2BoundingBox };
 //# sourceMappingURL=ITr2BoundingBox.js.map